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1.  INTRODUCTION 


POLAR  is  a  set  of  computer  programs  designed  to  predict  the 
electrical  interactions  between  the  natural  environment  and  a  large 
spacecraft  in  oolar  earth  orbit.  POLAR  consists  of  many  complex 
physical  models  which  have  been  converted  to  algorithms  and  connected 
by  an  executive  structure.  Since  there  are  a  wide  variety  of 
spacecraft  and  environments,  POLAR  has  been  written  with  maximum 
flexibility  and  applicability  in  mind.  However,  to  allow  for  when  a 
model  may  prove  inadequate,  POLAR  has  been  designed  with  a  high  degree 
of  modularity  to  enable  changes  in  the  physical  models  and  algorithms 
to  be  made  quickly  and  reliably.  The  documentation  is  also  designed 
modularly  so  that  code  modifications  can  be  documented  immediately. 

Thus  this  manual  is  intended  to  be  a  living  document,  accurately 
reflecting  the  most  current  status  of  the  POLAR  code.  This  modularity 
does  make  for  difficult  reading,  but  we  feel  that  the  total  information 
content  is  enhanced  and  that  it  is  a  valuable  compromise.  Since  the 
models  in  POLAR  are  subject  to  change  and  replacement,  it  is  important 
to  have  matched  editions  of  the  manual  and  the  computer  code.  The 
edition  date  for  this  manual  is  July  1984,  and  it  describes  the  edition 
of  POLAR  delivered  to  AFGL  in  July  1984. 

1.10  CODE  STRUCTURE 

POLAR  is  written  in  FORTRAN  in  accordance  with  top  down 
structural  programming  principles.  It  consists  of  four  main  programs 
and  one  attending  utility  program.  Program  one,  called  VEHICL,  handles 
object  definition.  Program  two,  called  ORIENT,  is  used  to  reorient  an 
object  and  the  grid.  Program  three,  called  NTERAK,  actually  calculates 
the  spacecraft-plasma  interaction  and  most  of  the  physical  models  are 
contained  in  NTERAK.  The  fourth  program  is  called  SHONTL,  and  it 
controls  plotting  and  information  retrieval.  The  fifth  program  or 
utility,  PLOTREAD,  translates  tht  machine  independent  output  of  SHONTL 
to  local  plot  commands. 


1  PREVIOUS  PROS 
IS  tLANK 


1.20  DOCUMENTATION 


This  document,  as  its  code,  is  structured  heirarchically.  The 
description  of  POLAR  goes  from  basic  physics,  to  physical  models,  to 
algorithms,  to  coding  structure,  and  finally,  to  operating 
constructions.  As  of  this  date  (Augt st  1983)  many  of  the  sections  are 
missing  as  is  much  of  the  coding.  A;  more  coding  comes  on  line  it  will 
be  reflected  in  additions  to  this  document. 


3.1-1 

3.  PHYSICAL  MODELS  EMPLOYED  IN  THE  POLAR  CODE 

The  POLAR  code  makes  various  assumptions  which  enable  it  to 
perform  three-dimensional  charge  calculations  in  relatively  short 
Debye  length  plasmas.  Ir  this  section  we  examine  the  component 
physical  models  and  disetss  their  validity.  While  each  is  addressed 
separately,  the  code  achieves  a  self-consistent  solution  by  various 
levels  of  iteration.  These  afre  described  more  fully  in  Chapter  4, 
Computational  Techniques.  This  chapter  provides  a  so-called  executive 
summary  of  the  models  as  if  the  numerics  were  arbitrarily  accurate. 
Numerical  techniques  are  discussed  in  greater  detail  in  Chapter  4. 

One  major,  overriding  assumption  should  be  identified  before  the 
component  by  component  description,  which  is  that  all  time  dependence 
on  the  scale  of  particle  dynamics  is  Ignored.  This  means  that 
particles  see  spatially  oependent  but  time  Independent  fields  for  the 
period  they  are  near  the  orbiting  vehicle.  As  such,  all  plasma 
oscillations,  including  electron  and  ion  modes  are  precluded.  Thus, 
oscillations  in  the  wake  or  at  leading  edges  will  not  be  predicted  by 
the  POLAR  code. 

3.10  THE  POLAR  PLASMA  ENVIRONMENT 

POLAR  can  model  a  wide  variety  of  plasma  environments  from 
reasonable  combinations  of  the  following  populations: 

Ions; 

Cool  Maxwellian  ions  (input  AMU). 

Cool  Maxwellian  protons. 

Both  the  protons  and  ions  are  assumed  to  be  isotropic  in  the  plasma 
frame.  The  relative  densities  are  controlled  by  imputing  the  density 
ratio  with  the  total  constrained  to  equal  the  ambient  electron 
density.  Both  populations  have  temperatures  equal  to  the  temperature 
1  of  the  cool  electrons. 


Electrons: 

Cool  ambient  Maxwellian,  temperature  1,  density  1. 
Suprathermal,  power  law  distribution  of  energies. 

Hot  Maxwellian,  temperature  2,  density  2. 

Energetic,  Gaussian  distribution  of  energies. 

The  cool  Maxwellian  population  is  considered  isotropic  in  the 
plasma  fVame.  The  other,  more  energetic  populations  may  be  given 
f ield-aligned  and  loss-cone  distributions. 

Limitation: 

Currently,  many  of  the  options  listed  above  are  not  consistently 
implemented  throughout  POLAR.  Specifically,  all  electron  populations 
are  considered  isotropic,  and  the  proton  population  is  ignored  in  the 
sheath  model  (3.60).  These  restrictions  will  be  removed  in  future 
work. 

3.20  PLASMA  POTENTIALS 

The  other  major  assumption  is  that  the  only  fields  of  major 
importance  are  the  static  electric  fields  obtainable  from  Poisson's 
equation  and  the  earth's  magnetic  field.  The  only  velocity  related 
field  included  is  that  induced  by  V  x  B  on  conducting  surfaces.  The 
frame  of  reference  is  chosen  to  be  the  stationary  plasma,  so  that 
V  x  B  effects  appear  on  the  vehicle  as  boundary  conditions.  The 

“S» 

plasma  at  infinity  is  defined  to  be  at  zero  potential. 

Plasma  potentials  are  obtained  from  Poisson's  equation 
v2d  -  x‘2(ni  -  ne) 

2  2 

where  x  Is  the  Debye  length  (x  -  eQ  kT/Ne  ),  and  the  charge 
density  is  that  of  the  ambient  plasma.  Contributions  from  hot  auroral 
electrons  and  particles  backscattered  from  the  vehicle  are  neglected. 


3.30  PARTICLE  DENSITIES 


3.3-1 


The  electron  dens it  '  is  assumed  to  be  Maxwellian  without  any 
excluded  orbits; 


where  ng  is  the  unpertur  ied  cold  component  plasma  density.  The 
absence  8f  excluded  orbit,  implies  neglecting  potential  barriers  for 
electrons  in  the  wake.  T  ie  validity  of  this  approximation  has  been 
studied  using  as  an  extre  ie  case  a  disk  moving  infinitely  fast  with 
respect  to  thermal  ions,  >ut  very  slowly  with  respect  to  the  electron 
thermal  velocity.  Such  at  object  has  rigorously  no  ion  charge  density 
in  the  wake  and  thus  has  :he  maximum  negative  space  charge  physically 
possible.  Solving  Poisson's  equation  for  this  case  gives  the  maximum 
possible  negative  plasma  potential.  The  central  wake  potential  as  a 
function  of  disk  radius  over  Oebye  length  is  shown  in  Figure  3.30/1. 

We  see  that  even  for  shuttle  size  objects  that  the' peak  space  charge 
potential  is  less  than  20  kT,  or  about  2  volts.  If  the  surface 
boundary  conditions  are  more  negative  than  this  wake  space  charge 
maximum,  the  potential  in  the  wake  will  be  monotonic  and  no  electron 
orbits  will  be  shadowed.  This  will  clearly  be  the  case  for  any  case 
with  substantial  negative  charging. 

The  ion  density  term  is  determined  using  one  of  two  models, 
depending  upon  the  local  potential.  At  large  distances  from  the 
object,  where  the  potential  is  near  plasma  ground,  that  is 
substantially  less  than  the  ram  energy  of  the  ions,  ion  orbits  are 
assumed  to  be  unperturbed  by  electric  fields.  In  this  presheath 
region,  ion  densities  are  determined  for  both  ions  and  protons,  by  the 
“neutral  ion  model"  described  next.  A  sheath  edge  is  assumed  to 
separate  the  presheath  from  a  sheath  region  wherein  electric  fields 
dominate  thermal  effects.  In  the  sheath  region,  ion  densities  are 
determined  by  sheath  ion  model  (3.32,  3.60). 


For  R/X 


ambient  Maxwellian  electrons 


3.3-3 

It  Is  Important  to  note  that  the  Ion  densities  that  result  from 
the  combined  use  of  the  neutral  ion  and  sheath  ion  models  are  subject 
to  certain  limitations  and  shortcomings. 

There  is  a  low  density  or  Laplace  limit  where  the  sheath  edge  is 

no  longer  sharply  defined  and  electric  fields  extend  far  into  the 

plasma.  In  this  limit,  the  neutral  ion  approximation  would  fail,  and 

thermal  ion  motion  would  be  incorrectly  ignored  inside  the  sheath 

edge.  This  limit  is  characterized  by  a  Debye  screening  length  that  is 

comparable  to,  or  larger  than,  the  object  size.  This  does  not  mean 

that  POLAR  cannot  provide  useful  results  in  the  long  Debye  length 

limit,  since  the  space  charge  coupling  to  the  potentials  is  recuced  by 
_2 

a  .  The  user  should,  however,  understand  that  ion  densities  and 
sheath  ion  currents  (3.60)  can  be  in  error.  There  is  also  a  short 
Debye  length  limitation  that  occurs  when  the  Debye  length  is  very  much 
less  than  a  zone  size  and  cbject  potentials  are  low.  This  combination 
can  result  in  an  object  to  sheath-edge  distance  that  should  be  less 
than  a  zone,  which  is,  of  course,  impossible  to  model  accurately. 

This  limitation  is  further  discussed  in  Section  4.44,  and  illustrated 
in  an  example  in  Appendix  C-3. 

There  is  one  further  limitation  of  the  ion  density  model  that 
occurs  when  a  sheath  is  significantly  larger  than  an  object.  In  this 
case,  the  ion  densities  outside  the  sheath  will  have  been  determined 
by  the  neutral  ion  model  using  the  object  as  the  only  perturbation  to 
ion  orbits,  where  it  should  have  used  the  sheath  edge  inasmuch  as  a 
sheath  edge  can  be  considered  perfectly  absorbing  (Section  3.60). 

This  problem  is  scheduled  for  resolution,  but  presently  its  effect 
should  be  minimal  as  far  as  object  charging  is  concerned. 


3.31  THE  NEUTRAL  ION  APPROXIMATION 


In  some  regions  of  space  the  electric  fields  may  be  weak,  and 
potentials  less  than  both  the  ion  flow  energy  and  the  ion  thermal 
energy.  Here,  ion  motion  may  be  approximated  by  that  of  a  neutral 
particle  where  only  collisions  with  absorbing  objects  perturb  the  Ion 
density.  The  ion  density  In  this  region  is  calculated  taking  fully 
into  account  ion  thermal  velocities  but  Ignoring  bending  of 
trajectories  by  electric  or  magnetic  fields.  This  can  be  expressed  by 
the  following  equation: 


^(x,  v)  -  g(x,  )  f iQ( v) 


where  f.(x,  v)  Is  the  ion  distribution  function  at  a  point  x  in 
space  for  a  velocity  v  and  fio(v)  Is  the  unperturbed  velocity 
distribution  function  for  a  drifting  Maxwell  an  (the  assumed  condition 
at  an  infinite  distance  from  the  vehicle).  he  function  g(x,  «  )  has 
value  zero  if  a  ray  starting  from  x  going  in  the  direction  n  would 
strike  the  vehicle,  it  has  value  1  otherwise  This  function  takes 
into  account  particles  who  cannot  contribute  to  the  local  charge 
density  because  they  run  into  the  vehicle.  The  charge  density  is 
obtained  by  integration  over  velocities: 


ni(x) 


f f(x,v)dv 


f  g(x,n)  j  fi0(v  n)v2dv 

a  ~  o 


d  n 


Since  the  potential  varies  logarithmically  with  density  in  the  quasi¬ 
neutral  region  about  large  objects  in  short  Lebye  length  plasmas,  a 
factor  of  2  error  in  this  density  will  lead  to  less  than  one-tenth 
volt  error  in  the  local  potential;  thus  approximation  is  not  expected 
to  be  a  source  of  any  large  error. 


3.32  SHEATH  ION  DENSITIES 


Section  3.60  discusses  the  POLAR  sheath  model  and  the  sharp 
edged  sheath  concept.  The  derivation  of  Ion  densities  from 
trajectories  within  the  sheath  is  explained  in  4.42.5.  What  follows 
here  is  a  brief  outline. 

Given  a  sheath  edge,  currents  from  "infinity"  to  the  sheath  edge 
are  calculated  analytically  using  orbit-limited  theory.  These 
currents  are  assigned  to  a  set  of  "super  particles"  (Reference  3-5) 
that  are  tracked  inwards  from  the  sheath  edge  to  the  vehicle  surface. 
Ion  densities  are  determined  from  the  product  of  the  particle  current 
and  the  time  that  a  particle  spends  in  an  element,  and  by  the  focusing 
of  trajectories. 


3.40  INCIDENT  CURRENTS 


POLAR  models  a  number  of  charged  particle  sources  as  responsible 
for  surface  and  vehicle  charging.  These  are  ambient  ions  and 
electrons,  energetic  electrons,  ion  and  electron  generated  secondary 
electrons,  and  photoelectrons. 


POLAR  is  presently  constructed  to  model  plasma  interactions  with 
a  negatively  charged  vehicle.  Since  the  comments  of  Section  3.30 
concerning  potential  barriers  apply  here  as  well,  we  can  assume  the 
ambient  electrons  to  be  repelled  with  no  excluded  orbits  within  the 
hemisphere  of  velocities  impinging  upon  a  surface.  When  these 
conditions  are  met,  the  velocity  space  integrals  over  a  Maxwellian 
distribution  decouple  from  the  surface  potential  and  we  may  write 


v*> 


eeV/kT 


For  the  energetic  electron  sources,  the  current  integrals  are  more 
involved.  These  are  discussed  further  in  Section  3.41  and  presented 
in  Sections  4.52.3  -  4.52.5. 

The  ions  are  presently  the  attracted  specie  in  POLAR.  The 
calculation  of  ion  currents  is  discussed  in  Section  3.42. 


3.41 


INCIDENT  ELECTRON  CURRENTS 


3.4-2 


A  statistical  study  (Ref.  3-1)  of  high  latitude  precipitating 
electrons  has  shown  that  these  fluxes  can  be  well  represented  by  the 
following  parametric  expression 


-C(E-E0)/fi]2 

♦  (E)  *  AE~°  +  Cn  - L-pj-  e_E/kT  +  E  Be  (3.41-A) 

(kT)JU 


These  are  the  power  law,  hot  Maxwellian  and  Gaussian 

1/2 

distributions  mentioned  in  Section  3.10,  where  C  «  (2  m  )  . 

-3/2  e 

it  ,  and  A,  a,  n,  T,  B,  EQ  and  6  are  parameters  determined  by 

the  particular  shape  of  a  spectrum.  Here,  *  (E)  has  units  of 
2 

#/m  .  s  ,  str  ,  keV.  To  apply  these  distributions  to  the  charging 

of  a  surface,  it  is  necessary  to  formulate  the  distribution  function, 
f,  at  the  surface.  We  start  by  disecting  Eqs.  (3.41-A).  Equation 
(3.41-A)  appears  to  assume  a  zero  space  potential  because  a  factor  of 
E  (total  energy)  rather  than  K  (kinetic  energy)  is  used  for  the 
velocity  or  energy  space  differential  volume  unit.  We  next  invoke  the 
Vlasov  equation  to  allow  a  mapping  of  f  along  a  trajectory  connecting 
the  surface  to  "infinity".  In  doing  so,  we  replace  the  one  factor  of 
E  with  K,  while  elsewhere  setting  E  *  K  +  qV  where  q  is  the  particle 
charge  b,  and  V  is  the  surface  voltage.  Thus,  we  write, 

f  (K,V,<|i)  =  A(  <//)  V  (K  +  qV)'(a+1) 


+ 


2 


E 


FeM 

(kTe)K 


exp(-(qV  +  K)/k  Tg) 


BU)  exp(-(K  -  Kq)2/a2) 


+ 


3.4-3 

The  index  e  covers  both  hot  and  cold  electrons,  and 
F  («l>)  »  g(ip)*ne*  ^kT/2irm  which  is  the  thermal  flux  multiplied  by  a 
a  function  of  the  pitch  angle.  The  net  electron  current  density  at  a 
surface  is,  of  course. 


W  2  2u  U 

f  d*  f  de  f 

Jo  Jq  A 


k  dK  f(K,V,iJi)  cose  sine 


The  relation  between  the  pitch  angle  <l>,  and  the  spherical  polar  angles 
of  the  surface  normal  is: 

ip  *  arccos[cosY  cost  +  sin*  sine  cosd] 

where  y  is  the  angle  between  the  surface  normal  and  the  magnetic 
field.  These  angles  are  illustrated  in  Figure  3.41-1. 

A 

n 


Figure  3.41-1. 


3.4-4 

It  is  important  to  note  that  in  composing  f  at  a  surface  from  f  at 
infinity,  the  angular  factor  in  f,  A(i/>),  g(tp) ,  and  B(4»),  may  evolve 
dramatically.  Ultimately,  POLAR  will  estimate  the  angular  evolution 
of  the  electron  distribution  function,  as  this  may  be  important  for 
some  narrow  high  energy  distributions  as  well  as  necessary  for  the 
prediction  of  magnetic  field  effects.  However,  since  the  usual 
tendency  is  for  the  repelled  specie  distribution  to  broaden  (POLAR 
currently  assumes  all  surface  anc  space  potentials  to  be  negative), 
our  first  guess  will  be  to  assume  f  to  be  isotropic  at  all  surfaces. 

The  energy  integration  limits,  U  and  L,  are  0  and  ®  for  the 
Gaussian  and  Maxwellian  distributions,  but  a  lower  cutoff  must  be 
imposed  on  the  power  law  distribution.  This  cutoff  is  physical  in  its 
origin  as  the  electron  currents  a^e  finite,  but  determining  it 
accurately  is  not  always  po.sible.  POLAR  uses  a  100  eV  default  cutoff 
which  may  be  changed,  or  alternatively  the  total  current  for  these 
electrons  may  be  specified  and  a  reasonable  cutoff  will  be  deduced  by 
POLAR. 

POLAR  integrates  each  population  separately.  These  integrations 
are  described  in  Section  4.  >2. 


3.42  ION  SURFACE  CURRENTS 


POLAR  presently  considers  two  positively  charged  particle 
sources;  one  specie  of  ion  (singly  charged  with  a  variable  mass),  and 
protons.  As  the  attracted  species,  the  calculation  of  the  ion  current 
density  at  a  surface  is  a  non-local  problem  which  often  depends 
critically  upon  the  shape  of  the  orbits  that  bring  ions  to  the  surface 
(Reference  3-2).  That  is,  the  problem  is  generally  numerical  with  few 
exceptions  that  yield  to  analytic  evaluation.  POLAR  calculates  these 
currents  as  part  of  its  sheath  model,  so  the  reader  is  referred  to 
Section  3.60  for  further  information,  and  a  brief  discussion  follows 
here. 


External  to  a  sheath  edge  "orbit-limited"  (Reference  3-2  and 
Section  3.60)  conditions  may  be  assumed  which  will  allow  a  flowing 
Maxwellian  velocity  distribution  to  be  analytically  Integrated  to  find 
the  ion  currents  to  the  sheath  edge.  These  currents  are  assigned  to 
representative  particles  that  are  traced  inwards  to  the  object  surface 
to  yield  ion  surface  currents.  This  calculation  is  performed  as  a 
portion  of  the  POLAR  sheath  model  which  is  executed  as  the  CURREN 
module  of  NTERAK  (see  Chapter  5  for  POLAR  code  structure). 


3.50 


ELECTRICAL  CHARGING 


The  electrical  charging  of  the  spacecraft  is  modeled  using  a 
circuit  analogy.  rhe  plasma  around  the  craft  becomes  a  current  source 
with  a  capacitance  between  the  plasma  and  the  object's  surface.  The 
spacecraft  is  modeled  as  a  network  of  capacitors,  resistors,  and 
voltage  sources.  The  basic  charging  equation  is 

I(t)  =  C  ^  /( t)  -  o  V(t)  (3.50-A) 


where  I  is  current,  C  capacitance,  a  conductance,  and  V  is  voltage. 
Each  surface  (the  smallest  mesh  unit  sized  square,  triangular  and 
rectangular  building  block)  contributes  a  component  to  the  current  and 
voltage  vectors. 

Surface  volt,  ges  are  updated  (integrated)  by  timestepping  a 
finite  difference  approximation  to  Eq.  (3.50-A)  (4.51).  This 
integration  frequently  proves  to  be  difficult  because  of  the  wide 
range  of  capacitance  that  can  occur  in  the  C  matrix.  For  instance,  a 
surface  to  plasma  :apacitance  might  be 

C  C 

^  ^  =  10  pf/m2 

where  A  is  the  surface  area  and  R  is  an  effective  radius,  whereas  the 
surface  to  conductor  capacitance  of  a  dielectric  might  be 

Cb  M  e  ,  n  f/2 

TS - 7T  Wt/m  . 


Thus,  a  driving  current  of  10  A/m  would  produce  charging  rates 
6  2 

of  10  volts/ sec  and  10  volts/ sec.  Obviously,  these  two  extremes 
would  require  different  timesteps  for  a  simple  explicit  integration. 

The  stability  difference  between  the  explicit  and  implicit  forms 
can  be  demonstrated  by  a  simple  scalar  analog. 

Explicit:  C[V(t2)  -  V(t^) ]  -  I(t^)  .  At 
Implicit:  C[V( t2)  -  V(t^) ]  «  I(t2)  .  At 

Substituting 

I(t2)  -  I(t1)  +  I'(V(t2)  -  V ( tj } )  (3.50-B) 

gives 

I(tn)  At 

V(t2)  -  V(tx)  -  C  _  fin 

If  we  take  a  case  of  C  -  10~^  f,  I(tj)  »  10~6  A, 

At  =  1  sec,  I'  *  -10  **  A/volt  we  find 

5 

Explicit:  aV  *  10  volts 
2 

Implicit:  aV  *  10  volts 

That  the  explicit  answer  is  unstable  is  indicated  by  plugging  aV 

-3 

into  Eq.  (3.50-B)  giving  I(t2)  =  -10"  A  (explicit)  or 
I(t2)  *  10"^  A  (implicit). 

POLAR  utilizes  both  explicit  and  implicit  timestepping  to  allow 
large  timesteps  for  the  large  capacitances  while  maintaining  accuracy 
and  stability  for  the  smaller  capacitances.  Details  of  implementation 
can  be  found  in  Sections  4.51  and  5.70. 
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3.60 


THE  POLAR  SHEATH  MODEL 


The  concept  of  a  plasma  sheath  requires  definition.  In  general, 
the  plasma  sheath  can  be  defined  to  be  the  region  of  non-neutral 
charge  density  that  shields  a  charged  body  from  distant  plasma.  A 
more  precise  definition  should  distinguish  between  an  "orbit-limited" 
sheath  and  a  "space  charge-limited"  sheath.  Investigations  into 
current  collection  by  Langmuir  probes  (Ref.  3-2,  3-3)  in  the  long 
Debye  length  limit,  have  shown  that  current  collection  is  orbit- 
limited,  i.e.,  on  the  surface  of  a  probe,  distribution  functions  are 
filled  over  a  hemisphere,  and  are  related  to  the  distant  plasma 
distribution  function  by  constants  of  the  motion  or  "orbits".  As  the 
Debye  length  is  shortened,  current  collection  remains  orbit-limited 
until  the  charge  density  is  sufficient  to  cause  the  electric  potential 
to  decrease  faster  than  the  inverse  square  of  the  radial  distance.  At 
this  point,  current  collection  is  said  to  be  space  charge-limited. 

An  important  feature  of  the  orbit-limited  sheath  is  that  the 
particle  currents  to  a  surface  are  independent  of  the  exact  shape  of 
the  potential  well,  making  it  possible  to  derive  general  expressions 
for  currents  and  densities.  The  opposite  is  true  of  the  space  charge- 
limited  sheath  where  currents  and  densities  must  be  calculated 
numerically  by  following  trajectories  in  potential  wells  that  must  be 
consistent  with  the  particle  densities.  The  many  approaches  to  this 
problem  have  been  reviewed  recently  by  Laframboise  (Ref.  3-4). 

POLAR  must  model  the  space  charge-limited  extreme,  which 
dictates  the  use  of  some  trajectory  tracing.  Efficiency  is  maintained 
by  recognizing  that  orbit-limited  conditions  exist  in  the 
quasi-neutral  region  outside  the  sheath,  and  that  trajectories  must  be 
followed  only  inside  the  sheath.  POLAR  thus  makes  a  sharp  sheath  edge 
approximation  to  divide  a  problem  into  the  two  regimes.  Fluxes  from 
"infinity"  to  the  sheath  edge  are  calculated  analytically  using  orbit- 
limited  theory  (Sections  3.42,  4.42.2).  These  fluxes  are  then  assigned 


3.6-2 

(Section  4.42.3)  to  trajectories  that  are  tracked  (Section  4.42.4) 
through  the  sheath  to  determine  particle  densities  in  the  sheath 
(Section  4.42.5)  and  surface  currents  (Section  4.53).  Of  course,  for 
the  self-consistent  probe  problem,  POLAR  must  iterate  between  sheath 
density  solutions  and  Poisson  solutions,  and  for  a  charging  problem  a 
higher  level  of  iteration  updates  the  surface  potentials  and  iterates 
with  the  sheath-Poisson  solution. 

The  sheath  edge  is  nominally  chosen  to  be  the  0.47  kT  potential 
contour.  For  a  spherical  probe  in  a  non-flowing  plasma,  this  is 
consistent  with  previous  investigations  (Refs.  3-5,  3-6).  In  the 
presence  of  net  plasma  flow,  POLAR  maintains  the  0.47  kV  sheath  edge 
choice,  but  it  is  presently  not  clear  what  the  best  choice  for  the 
sheath  edge  will  be  for  high  flow  problems. 

There  are  two  major  approximations  made  in  the  POLAR  sheath 
model.  The  first  is  the  so-called  sharp  sheath  edge  approximation. 
This  assumes  that  there  is  a  sharp  boundary  between  non-neutral  sheath 
and  the  surrounding  quasi-neutral  presheath  region.  For  large  objects 
in  short  Debye  length  plasmas  this  is  a  very  good  approximation.  The 
other  approximation  is  that  thermal  effects  within  the  sheath  are 
small,  i.e.,  from  a  given  position  on  the  sheath  boundary,  that  a 
single  trajectory  is  adequate  to  represent  all  particles  entering  from 
that  position.  This  implies  that  potentials  exist  in  the  sheath  such 
that 


* 

FT 


»  1 


and  that  the  electric  fields  near  the  sheath  edge  are  sufficiently 
strong  so  that  a  velocity  space  element  is  accelerated  rapidly  and  its 
thermal  spread  is  small; 

*th  •  « L 

where  v^h  is  the  ion  thermal  velocity,  x  is  the  transit  time  from 
the  sheath  edge  to  the  vehicle,  of  characteristic  dimension  L. 
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4.  COMPUTATIONAL  TECHNIQUES 


This  section  describes  the  algorithms  used  to  implement  the 
physical  model. 

4.10  GRIDS  -  DISCRETIZATION  OF  SPACE 

POLAR  is  a  three-dimensional  computer  code;  that  is,  its 
internal  representation  of  space  allows  variations  in  all  three 
coordinate  directions.  Since  problem  set-up  can  be  extremely  complex 
in  three-dimensions,  the  choice  was  made  to  keep  the  spatial 
coordinate  system  as  simple  as  possible.  Space  is  divided  uniformly 
into  cubes.  The  computer  code  stores  information  about  a  large  set  of 
cubical  volumes,  called  elements.  It  also  stores  values  of  electric 
potential  for  the  corners  of  the  elements.  The  corners  are  referred 
to  as  nodes. 

4.11  STAGGERED  MESH 

The  coordinate  system  used  in  POLAR  is  Cartesian.  This  greatly 
simplifies  object  definition  and  converting  positive  vectors  into 
element  locations.  However,  the  ;ypes  of  problems  POLAR  is  designed 
to  handle  are  very  anisotropic.  rhe  density  and  potential 
perturbations  are  along  the  wake  direction  and  can  extend  for  several 
vehicle  diameters.  To  provide  re;olution  in  this  wake  region  but  not 
occupy  an  excessive  amount  of  computer  storage,  a  system  of  staggered 
meshes  has  been  implemented.  The  staggered  mesh  consists  of  square 
layers  of  elements  that  are  only  one  mesh  unit  deep  in  the 
z-direction.  They  are  stacked  upon  each  other  so  that  the  center  of 
each  layer  is  as  close  to  the  wake  center  as  possible  and  still  have 
the  nodes  at  integer  coordinates.  Since  this  extension  always  is  in 
the  z-direction,  the  object  coordinates  can  be  transformed  by  a  90* 
rotation  matrix  so  that  an  arbitrary  Mach  vector  can  be  accommodated. 


The  problem  space  is  unrestricted  in  the  z-direction  so  that  viable 
results  may  be  obtained  for  large  Mach  vectors  in  lower  density  plasma. 

Examples  of  grids  for  two  objects  are  shown  in  Figure  4.11/1. 

4.12.  OBJECT  GRID 

• 

The  object  grid  is  the  space  in  which  the  object  is  defined. 

This  subsection  of  the  grid  space  is  non-stepped  and  is  a  regular 
prism.  The  object  must  be  defined  so  that  it  fits  entirely  within 
this  space. 

The  object  grid  also  serves  as  the  coordinate  reference  point 
for  the  entire  problem.  The  lowest  point  on  the  x,  y  and  z  axis  (low 
leftmost  corner)  is  defined  to  be  the  origin  and  has  the  coordinate 
value  of  (1,1,1). 


4.21 


FINITE  ELEMENTS 


4.21.1  GENERAL 

Consider  a  charged  object  isolated  in  :pace.  The  potential  t 
everywhere  is  given  by  the  solution  to  Poiss<n's  equation 


(4.1) 


The  variational  principle  associated  with  this  equation  is  given 
by: 


where  we  integrate  over  both  the  object  and  boundary  surfaces  (cs, 
CB)> 


To  simplify  things  for  the  purpose  of  illustration,  let  us  fi> 
the  potentials  on  these  surfaces  and  assume  *ero  charge  density. 

The  equation  then  simplifies  to 


Equation  (4.2)  involves  an  integral  over  the  volume  of  the 
computational  space.  One  way  to  treat  this  integral  is  to  divide  the 
space  up  into  finite  cubic  volume  elements. 


/dv£(v*)2=^  /  dVe^(v*)J 


e  Ve 

In  this  approach  tne  potential  t  is  defined  at  each  grid  point,  or 
node,  defining  the  vertices  of  the  elements.  The  potential  inside 
each  element  is  th  ;n  trilinearly  interpolated  from  the  values  of  each 
of  its  eight  vertices. 

*e  (x,y, z)  «  ^  N.xyz  Pi 
i€e 

where  "i"  are  the  nodes  of  element  "eM 


(x.y.z)  -^VN.xyz  t. 
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The  quantity 


.  / dve  ’■  .  2 


(4.3) 


is  completely  defined  just  by  knowledge  of  the  shape  of  the  element 
"e“  ( i . e . ,  whether  the  cube  is  empty  or  partially  filled).  For 
screening  purposes,  we  also  require 


-  /dve  Nj' 


(4.4) 


The  variational  principle  therefore  becomes: 
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Equation  (4.4)  becomes 


(4.5) 


6 


£  *iVj 

ij 


Thus  the  set  of  t  values  at  each  node  [t)  thi t  satisfy  M  i  is  the 
solution  to  the  Poisson  equation  (4.1)  under  conditions~of  fixed 
object  and  boundary  potentials  and  zero  charge  density. 


We  may  solve  Eq.  (4.4)  iteratively.  Our  initial  choice  of  t 
will  yield  a  residual  r 

M  t  ~  -r 

*v 

The  iterative  scheme  used  is  the  Conjugate  Gradient  technique.  It  is 
based  on  the  following  equations: 


a1  =  (ri,ri)/(ui,  M  u1) 

.i+1  .i  .  i  i 
t>  -  t  +  a  u 


(r 


i+1  _i+l 


r1+1)/(rV) 
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These  equations  may  be  iterated  upon  until  the  resultant  6  vector 
becomes  the  solution  to  Poisson's  equation. 

The  major  computational  operation  in  the  iterative  set  of 
equations  is  the  evaluation  of  the  matrix-vector  product  M  u.  The 
vectors  d,  u,  and  r  all  have  the  same  number  of  elements  as  the  number 
of  grid  points.  M  contains  the  square  of  this  number.  Such  a  huge 
array  is  impractical  to  store  all  at  once  and  so  M  u  is  evaluated 
using  the  following  implicit  algorithm 

T  *  “2  ~e~ 

e  e  ~ 

The  wa  matrices  are  of  reasonable  dimension,  for  example,  8x8  for 
an  empty  cube.  The  residual  r  is  constructed  element  by  element  and 
then  summed.  These  "weight"  matrices  w.  may  be  calculated 
analytically  for  each  type  of  empty  or~partially  filled  volume 
element,  allowed  by  POLAR.  There  are  seven  of  these.  Filled  cells 
are  not  included  in  the  potential  calculation.  This  is  how  POLAR 
treats  filled,  partially  filled  and  empty  elements,  differently. 
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SPECIAL  CELLS 


The  geometry  of  NASCAP/POLAR  objects  can  be  treated  in  terms  of 
a  relatively  small  number  of  volume  cells.  Each  type  has  a  maximum  of 
eight  corner  nodes,  plus  a  node  at  the  center  of  each  possible  surface 
pointing  into  the  element.  The  most  common  volume  element  (designated 
type  0)  is  the  empty  cube  with  no  surfaces.  Other  elements  are: 

a.  The  empty  cube  with  up  to  6  surfaces  (also  type  0); 

b.  The  wedge  element  (type  1); 

c.  The  empty  element  with  a  diagonal  line  (produced  by  a  right- 
triangle  surface  or  a  slanted  thin  plate)  on  one  face  (type  2); 

d.  The  tetrahedron  (type  3); 

e.  The  truncated  cube  (type  4); 

f.  The  slanted  thin  plate  (type  5  . 

Each  element  is  characterized  by  (1)  a  standard  orientation; 

(2)  a  set  of  interpolation  functions  (see  4.21.21  for  treatment  of 
surface  nodes);  (3)  the  matrix  W,  given  by  Eq.  4.3,  which  represents 

p  ft* 

the  operator  -v  in  Poisson's  equation;  and  (4)  the  matrix  V, 
defined  by  Eq.  4.4,  which  handles  the  screening  part  of  Poisson's 
equation. 
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4.21.21  INTERPOLATION  FUNCTIONS  FOR  FACE-CENTERED  SURFACE  NODES 
(FCSN'S) 

In  constructing  the  matrices  W  and  V  for  volume  cells  with 

N  A# 

FCSN's  it  is  convenient  to  work  with  the  vector  *  T  4>t  where,  for 
corner  nodes,  has  identical  entries  to  the  potential  vector  4,  but 
for  an  FCSN  the  f  entry  is  the  difference  between  its  electrostatic 
potential  and  the  average  of  that  of  its  corners.  In  terms  of  t p, 
corner  node  interpolation  functions  are  constructed  neglecting  the 
FCSN's,  and  FCSN  interpolation  functions  are  unity  at  the  FCSN  and 
zero  on  all  other  faces.  In  terms  of  these  interpolation  functions, 
the  matrices  W  and  V  are  defined  by 

f\  V*|2  d3r  -  W  t>  -  <JiT  A 

ft2  d3r  «  V  i>  -  i|/T  B  \p 


where  the  integrals  are  over  the  element  volume,  and  we  have  defined 
and  B,  which  are  readily  siown  to  be  given  by 


Aij  " '  7f,J  d3r 
Bij.  .  JHy  NJ  d3r  . 


Finally, 
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The  matrices  T,  W  and  V  are  given  for  each  element  type  in  the 

A*  A» 

succeeding  sections. 
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THE  EMPTY  CU8E  (TYPE  0)  ELEMENT  WITH  NO  FCSN'S 


Standard  Cell  0 
Empty  tril Inear  cube 
Orientation:  Arbitrary 
Potential  Function: 

i  N1 
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2  (l-z)(l-y)x 

3  (l-x)y(l-z) 

4  (l-z)yx 

5  z(l-y)(l-x) 

6  x(  1— y )  ( z) 

7  zy(l-x) 

8  xyz 

WiJ 

1/3 


0 

1/3 

0 

-1/12 

1/3 

-1/12 

0 

0 

1/3 

0 

-1/12 

-1/12 

-1/12 

1/3 

-1/12 

0 

-1/12 

-1/12 

0 

1/3 

-1/12 

-1/12 

0 

-1/12 

0 

-1/12  1/3 

-1/12 

-1/12 

-1/12 

0 

-1/12 

0  0 

1/27 

1/54 

1/27 

1/54 

1/108 

1/27 

1/108 

1/54 

1/54 

1/27 

1/54 

1/108 

1/108 

1/216 

1/27 

1/108 

1/54 

1/216 

1/108 

1/54 

1/27 

1/108 

1/216 

1/54 

1/108 

1/54 

1/108 

1/216 

1/108 

1/108 

1/54 

1/108 

1/54 

4.21.23 


THE  EMPTY  CUBE  (TYPE  0)  ELEMENT  WITH  SIX  FCSN'S 


7  8 


Figure  4.21.23/1.  Cubical  finite  elements  with  six  face-centered 

surface  nodes  (FCSNs).  The  FCSNs  are  located  on 
the  +x,  +y,  +z  faces  respectively. 
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Figure  4.21.23/2.  Interpolation  functions  for  the  cubical  element  of 

Figure  4.21.23/1. 
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4.21.25  THE  TYPE  2  ELEMENT 

Cube  with  Diagonal  Line  on  One  Face 
Orientation:  Line  from  2  to  3 

Node  Location  Interpolation  Function,  Ni 


1 

0 

0 

0 

(x-y)Fe(x’-y) 

2 

1 

0 

0 

[xe(x-y)  +  ye(x-y)]z 

3 

0 

1 

0 

[yo(x-y)  +  xe(x-y)]z 

4 

1 

1 

0 

(x-y)Fe(x-y) 

5 

0 

0 

1 

x  y  z 

6 

1 

0 

1 

x.yz 

7 

0 

1 

1 

x  y  z 

8 

1 

1 

1 

x  y  z 

9 

0 

1/2 

1/2 

16  x  y  y  z  z 

10 

1 

1/2 

1/2 

16  x  y  y  z  z 

11 

1/2 

0 

1/2 

16  x  x  y  z  7 

12 

1/2 

1 

1/2 

16  x  x  y  z  7 

13 

1/2 

1/2 

1 

16  x  x  y  y  z 

14 

1/3 

1/3 

0 

27  x  y  F(7-y)e(F-y) 

15 

2/3 

2/3 

0 

27  x  y7(x-y)«(x-y) 

for  Typa  t  (9paolal  Empty  Cub*)  El  am  ant 


for  typo  S  (Spool* I  Empty  Cubo)  Element 


The  Matrix  W 

For  the  Type  3  (Tetrahedron)  Volume  Element 


4.21.27  THE  TRUNCATED  CUBE  ELEMENT  (TYPE  4) 


Truncated  Cube  (Type  4) 
1  <  x+y+z  <  3 
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MATRIX  SOLVERS 


4.3-1 


POLAR  (NTERAK)  currently  uses  two  methods  to  solve  matrix 
equations  of  the  form 

N  X  «  d 

where  M  is  a  given  matrix,  d  is  data  and  X  is  the  solution  vector. 
These  methods  are  the  Conjugate  Gradient  Method  and  the  Incomplete 
Cholesky  Conjugate  Gradient  Method  (ICCG). 


V- V  V  .’>•>>  V  '  v> VvV  >>>>  *V*V  V '>>>* 
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CONJUGATE  GRADIENT  METHOD 


This  method  is  used  for  the  Poisson  equation  solution  (4.20, 
4.44)  where  X  «  0  (potential)  which  can  have  10,000  or  more 
components.  The  next  revision  of  this  document  will  have  a  complete 
discussion  of  this  method. 


4.32  ICCG,  THE  INCOMPLETE  CHOLESKY  CONJUGATE  GRADIENT  METHOD 

ICCG  is  used  to  solve  the  charging  equations  (4.50,  5.70),  where 

X  «  Vc,  surface  voltages.  Components  of  V.  generally  number  1000 
«» 

or  less.  This  allows  the  entire  problem  to  be  kept  in  the  machine 
(5.73.2).  ICCG  will  find  series  of  approximate  inverses  for  M  finding 

*3 

X  as 

X  -  M-1  d  . 

f*S  ** 

It  is  iterative,  but  iterates  on  M“*  as  well  as  X.  A  more  complete 
description  will  be  found  here  in  future  revisions.  Reference: 
Kershaw,  D.  (1978),  "The  Incomplete  Choi esky-Con jugate  Gradient  Method 
for  the  Iterative  Solution  of  Systems  of  Linear  Equations,"  Journal  of 
Computational  Physics,  26,  p.  43. 


4.40 


SPACE  CHARGE  AND  CURRENT  COMPUTATION 


This  section  describes  the  numerical  techniques  such  as 
integration,  that  are  used  to  effect  the  models  described  in  Chapter 
3.  In  some  cases,  the  computational  requirements  are  satisfied  by  the 
top-down  structuring  of  simple  subroutines.  In  these  cases,  the 
Chapter  4  discussion  is  deferred  to  Chapter  5  to  avoid  repetition. 

4.41  WEAK  FIELD  IONS,  PRESHEATH  AND  WAKE 

This  model,  presented  in  Section  3.30,  will  be  elaborated  upon 
here  in  future  revisions.  The  reader  is  currently  referred  to  Section 
5.61. 
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THE  POLAR  SHEATH  MODEL  (TECHNICAL) 


Section  3.60  contains  a.  general  discussion  of  the  POLAR  sheath 
model.  This  section  is  not  designed  to  be  a  complete  discussion,  but 
to  fill  in  the  technical  details  of  the  model. 

4.42.1  ION  SHEATH  EDGE  ALGORITHM  (SHEATH) 

The  SHEATH  routine  takes  as  input  a  sheath  edge  potential,  PMIN, 
and  the  eight  vertex  potentials  of  a  single  cubic  element,  P(2,2,2). 

It  determines  whether  the  sheath  potential  contour  passes  through  the 
specified  element  and  if  it  does  it  generates  a  number  of  triangles, 
NPART,  with  areas  W(I)  and  center  X(3,I)  which  approximates  the 
equipotential  surface. 

The  sheath  location  proceeds  by  finding  any  edges  whose  vertex 
potentials  bracket  the  sheath  potential.  If  none  do,  NPART  is  set  to 
zero  and  control  returns  to  the  calling  program.  For  the  cases  of 
three  intersections  a  single  triangle  is  constructed  from  the 
intersection  points  with  the  area  calculated  by  the  TRiangle  AREA 
routine.  For  four  or  five  edge  intersections  the  centroid  of  the 
intersection  points  is  found  and  triangles  constructed  using  adjacent 
intersection  points  and  the  centroid.  Thus  for  four  edge 
intersections,  four  triangles  are  formed.  SHEATH  then  would  return 
NPART  «  4  and  the  center  coordinates  of  each  of  the  four  triangles. 

4.42.2  ION  CURRENTS  TO  THE  SHEATH  SURFACE 

We  calculate  the  current  density  to  the  sheath  edge  by  assuming 
it  to  be  a  perfectly  absorbing  spherical  surface  in  a  flowing  plasma. 
We  assume  that  the  potential  around  the  sphere  is  spherically 
symmetric  and  attracts  ions.  We  utilize  the  coordinate  systems 


indicated  in  Figure  3.42/1  below  (shown  twice  to  reduce  cluttering) 


Figure  4.42/1. 

and  introduce  the  following  definitions: 


£  «  sphere  radius 

VQ  =.  satellite  velocity 

*(r)  *  potential  energy  of  ion  at  r 

n  «  unit  vector  at  position  r  on  sphere  where  normal 

current  density  is  to  be  calculated 

n^  «  unit  vector  in  final  dir|ction  £at  r  *  )  mapped^by 

particles  launched  f^om  r  ■  (a,n)  with  velocity  v 

x-z  plane  «  plane  determined  by  n  and  V 


=»  * 


=  angle  between  n  and  V 


polar  angle  of  particle  for  (n  *®,  nf) 


w 


angle  between  x-z  plane  and  orbital  plane 


(2w  Vj)  3/2jexp  -(J0  -  VQ)2/2vf< 


m 


ion  mass 
kT/m 


For  a  particle  moving  in  a  central  potential  the  conserved  quantities 
are  (e  =  m  -  1): 


\  v2  +  *(a)  *  i  v?  *  E 


7  vo 


Energy 


L  a  vasine 


Angular  Momentum 


Azimuth 


>  *  * 

The  normal  current  density  j(r)  at  a  point  r  =  (a,n)  on  the  sphere 


is  given  by 

¥  m  ¥  ¥  ¥  ■»> 

j  a  j(a,n)  -  J(v.n)  fQ( vQ)  d3v 


-3/2 


(2*  Vj)  exp  \  (V|  -  2Vqvo  cos*f  +  V2)/v2 


x  v°  cos©  sin©  dv  d©  d 6 


where 


cosipf  «  co$£  cose^  -  sinE  sin©,,,  cos# 

.2 


*«(Ve)  *  a  s1ne/T 


a  r 


1  .  •  sin2e  ♦  iLil  -  «lr) 


■.  -1/2 


Performing  the  0  integration,  which  can  be  done  analytically,  and 
using  energy  conservation. 


j  -  (2»Vj)  j  v0(vj  -  2*{a))  e 
■'0 


F(vq)  dvQ 


F(v0)  -  2.  / 

0 


rmax^  _Vqv  cos  5  cose$/v2  -V^/2v2 
e  e 


v  sin 
o  o 


n|  sine  \ 

2 - -)  sinp  cose  de 

T  ' 


where  I  is  the  modified  Bessel  function  of  zero  order, 
o 


For  numerical  calculations  we  define  t  *  x/ 3.75  and  approximate 


lo  by 


I(x)  -  1  +  3.5156229t2  +  3.0899424t4  +  1.2067492t6 
+  .2659732t8  +  .0360768t10  +  ,0045813t12  +  c 


c  <  1.6  x  10_ 


for  -3.75  <  x  <  3.75 


x1/2e"x  I  (x)  -  .39894228  +  .01328592  _1 


+  .00225319t-2  -  . 00157565t— 3 


+  .00916281t" 


.02057706t* 


+  .02635537-6  -  ..01647633t-77 
+  .00392377t“8  +  e 


c  <  1,9  x  10‘ 


for  3.75  <  x  <» 


For  an  inverse  square  potential 


®max  "  *72’  an<1  chan9e  *n  Polar  angle  can  be  found 


analytically 


,»  •>*">  v  V  /"i' ’l**”  s  s.’  * 


POLAR  is  currently  using  a  temperary  approximate  model  for 
initial  velocities  that  is  described  (ere.  This  model  will  be 
replaced  when  the  new  model  is  ready.  Initial  velocities  are 
approximated  by  adding  a  plasma  rest  frame  characteristic  velocity  to 
the  Mach  velocity,  (spacecraft  velocity  normalized  by  the  square 
root  of  (kT/m).)  The  characteristic  velocity,  Vc>  is  constructed  by 
first  realizing  that  inside  the  sheath  edge  the  density  contribution 
of  a  trajectory  is  simply  a  continuity  calculation  (convergence 
effects  come  from  the  convergence  of  trajectories).  Thus  we  estimate 
|  Vc  |  by  dividing  the  orbit-limited  flux  obtained  for  a  totally 
absorbing  surface  (Laframbolse  and  Parker,  ref.  4-4)  by  a  simplified 
form  for  the  orbit-limited  density  (accurate  in  the  low  potential 
limit). 


vc  -  "o  tC  (!*•>/  J  (**4) 


where  <P *  eV/kT,  and  the  ion  acoustic  speed  /kT/m  has  been  isolated 
to  indicate  the  usual  POLAR  velocity  localization.  The  direction 
assigned  to  Vc  is  the  normalized  Inward  E  field 


In  the  absence  of  flow,  this  result  is  exactly  the  result  that  would 
be  obtained  from  the  calculation  of  the  velocity  and  density  moments 
of  the  orbit-limited  distribution  function. 
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Our  present  (temporary)  treatment  of  flow  is  more  approximate. 
The  initial  sheath  particle  velocity,  V$,  is 


V. 


VM*VC 


If 


If 


<VM  *  V 


<»*  *  V 


•  E  >  0 


•  E  <  0 


where  the  conditional  insures  that  V&  is  always  directed  into  the 
sheath. 


4.42.3  SHEATH  PARTICLE  ASSIGNMENT 

Each  volume  element  of  a  problem  is  inspected  for  the  presence 
of  the  sheath  edge  equipotential  as  described  in  Section  4.42.1.  Each 
triangular  subsurface  of  the  sheath  is  a  potential  sheath  particle; 
however,  many  times  a  portion  of  an  equipotential  is  not  really  a 
source  of  current.  This  is  assumed  to  occur  when  there  exists  just 
"outside"  the  sheath  (in  the  anti  E  direction)  a  portion  of  the 
object,  or  a  high  potential  region  of  the  opposite  sign.  Both  of 
these  conditions  are  checked  by  calculating  the  inward  initial 
velocity  for  the  particle  as  per  Section  4.42.2,  reversing  it,  and 
tracking  the  particle  backwards  through  two  volume  elements.  If  no 
"obstacles"  are  found,  the  particle  Is  assigned  a  current  or  weight 
and  placed  in  a  particle  list.  This  list  is  later  read  and  the 
trajectories  advanced  as  described  in  Sections  4.42.4  and  5.62. 
Finally,  the  sheath  currents  and  velocities  are  not  calculated  for 
each  particle  but  interpolated  from  a  pre-calculated  table  of  values. 


4.42.4 


TRAJECTORY  TRACKING 


Trajectory  tracking  can  be  an  expensive  endeavor,  and  a  source 
of  unpredictable  error.  To  combat  these  problems,  POLAR  uses  two 
different  methods  to  follow  ion  trajectories  (presently,  there  is  no 
tracking  of  electrons). 


The  full  step  method  is  used  in  empty  elements  that  do  not  touch 
the  objectjwhere  complex  E  fields  are  not  anticipated.  For  these 
elements,  E  at  the  cell  center  is  used  for  the  entire  cell,  and  a 
single  step  parabolic  trajectory  is  calculated  for  the  element.  This 
is  accomplished  by  analyzing  Independently  the  three  components  of  the 
equation 


xi 


i-1 


+  V 


(1) 


for  the  shortest  time,  t,  that  a  particle  needs  to  reach  an  element 
face.  Negative,  imaginary  and  zero  t's  are,  of  course,  rejected.  A 
number  of  special  conditions  may  occur  Involving  round-off  errors  and 
the  traversal  of  exceedingly  small  paths  in  the  corner  of  elements. 

The  treatment  of  these  problems  are  discussed  in  detail  in  Section 
5.62.22.  Following  the  choice  of  the  shortest  valid  time,  the 
trajectory  is  advanced  to  another  (or  possibly  the  same)  element  face, 
where  its  new  total  energy  is  checked  aginst  its  original  value.  The 
new  total  energy  Is  1/2  mV  +  eV(x),  where  V(x)  is  the  bilinear 
value  calculated  for  the  exit  location  on  the  exit  face  of  the 
element.  The  energy  is  renormalized  by  adjusting  the  magnitude  of  V 
without  modifying  its  direction. 


For  volume  elements  that  border  the  object,  more  complex  E 
fields  are  anticipated  so  POLAR  uses  a  slower,  but  more  accurate, 
step-push  method  where  Eq.  (1)  is  Integrated  using  timesteps  estimated 
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to  be  approximately  0.1  of  the  element  traversal  time.  At  each  step, 
fT  is  determined  by  analytically  differentiating  the  trilinear 
potential  function  (Section  4.20).  The  step-push  method  and  the 
routines  that  affect  it  are  discussed  in  greater  detail  in  Section 
5.62.22. 


POLAR's  sliced  grid  system  (Section  4.11)  forces  additional 
computational  considerations  on  the  trajectory  tracking  because  only  a 
small  set  of  potentials  are  stored  in  core  at  any  one  time. 

Potentials  are  paged  in  and  out  in  slices  at  nodes  of  a  constant  z 
value.  As  a  result,  trajectory  tracking  is  controlled  by  a  "pusher" 
that  sweeps  back  and  forth  in  z,  advancing  all  trajectories  through 
the  space  between  z  and  z+1.  Trajectories  moving  opposite  the  pusher 
are  written  out  to  disk  and  picked  up  on  the  return  pass  (Section 
5.62.22).  Although  this  complicates  the  coding  somewhat,  there  is 
little  loss  in  efficiency,  and  a  bonus  in  that  trapped  orbits  can  be 
simply  controlled  by  limiting  the  passes  of  the  pusher. 

Magnetic  field  effects  are  also  included  in  the  POLAR  ion 
trjectories.  The  techniques  used  to  add  B  effects  were  presented  in 
the  quarterly  report  of  December  1983  (SSS-R-84-6486).  Future  manual 
revisions  will  have  that  discuss  on  included  both  here  and  in  Chapter 
5. 


4.42.5  SHEATH  ION  DENSITIES 

Once  a  sheath  edge  surface  has  been  located  and  subdivided 
(Section  4.42.1),  the  input  current,  J^,  calculated  (Section  4.42.2) 
and  that  current  assigned  to  a  representative  particle,  g,  (Section 
4.42.3),  the  particle  trajectory  is  followed  inward  as  described  in 
Section  4.42.4.  Ion  densities,  n^,  are  determined  in  each  cell  by 
observing  that  if  each  trajectory,  j,  represents  a  constant  current 
*  dq^/dt,  each  trajectory  makes  a  contribution  to  the  overall 
element  density  of 
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Anij  *  element  volume 

where  At  is  the  time  required  to  cross  the  volume  element.  The 
total  density  is  just 

ni  m  2  Anij  • 
j 


This  has  been  dubbed  the  method  of  weighted  deposition  (Ref.  3-5).  It 
can  be  seen  that  acceleration  effects  and  convergence  effects  are 
accounted  for  by  the  At,  and  the  Zj  respectively. 


This  method  demands  a  large  number  of  particles  for  good 
statistics  and  we  have  found  that  the  three  to  six  particles  per 
sheath  volume  element,  chosen  by  the  sheath  edge  algorithm  (Section 
4.42.1),  work  quite  well.  Problems  in  accuracy  can  still  be 
anticipated  when  there  exists  repulsive  regions  within  a  sheath,  or 
when  the  method  is  being  incorrectly  applied  to  an  orbit-limited 
problem  where  particles  might  numerically  diffuse  into  allowed  trapped 
orbits.  In  this  case  repeated  orbits  would  give  erroneously  high 
densities.  Even  in  strongly  space  charge-limited  sheaths,  unusual 
geometry  could  lead  to  trapped  orbits,  so  POLAR  sets  a  user  controlled 
limit  on  the  number  of  front-to-back  pushing  sweeps  (Section  4.42.4) 
to  control  this  problem. 


m 


« 


Finally,  these  sheath  ion  densities  are  known  as  RHOI's  in  POLAR 
and  are  calculated  by  the  CURREN  segment  of  NTERAK.  The  ultimate  use 
of  these  densities  in  the  Poisson  solution  are  discussed  in  Section 
4.43.2. 


? 
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4.43  CHARGE  DENSITY 

4.43.1  ELECTRONS 

POLAR  presently  considers  only  negative  potentials.  Thus 
electrons  are  repelled  and  are  approximated  by  an  isotropic  Boltzmann 
equilibrium  distribution,  i.e., 

* 

ne  "  n0  exP(ey(x)/kT)  . 

This  approximation  may  be  invalid  near  weakly  repelling  surfaces, 
space  potential  barriers,  and  in  magnetically  insulated  regions. 

Other  conditions  may  arise  where  the  electron  distribution  will  not  be 
isotropic  and  a  Boltzmann  distribution  would  not  be  justified.  As 
positive  potentials  are  introduced,  or  as  other  conditions  require,  a 
more  elaborate  electron  model  will  be  adopted. 

4.43.2  ION  CHARGE  DENSITY 

Ions  are  considered  to  be  the  attracted  specie  in  POLAR.  This, 
plus  an  allowance  for  possibly  high  Mach  numbers,  means  that  ion 
densities  may  not  be  determined  by  any  local  approximation.  Thus  ion 
densities  are  currently  determined  by  two  methods:  Weak  field  ions 
(Section  4.41)  known  in  the  POLAR  coding  as  GI's  (geometric  ions);  and 
sheath  ion  densities  (Section  4.42)  known  in  the  coding  as  RHOI's. 

GI's  are  determined  at  the  onset  of  a  calculation  and  remain 
unchanged  thereafter.  The  RHOI's  are  calculated  whenever  a  CURREN 
step  (the  sheath  ion  tracking  process)  is  called  for.  Immediately 
following  a  CURREN  step,  POLAR  creates  from  these  two  data  sets,  an 
ultimate  ion  density  list,  the  DION's  that  are  used  in  the  Poisson 
calculation.  This  is  done  by  choosing  RHOI's  for  elements  inside  the 
sheath,  and  GI's  for  points  outside.  For  elements  containing  a 
portion  of  the  sheath  surface,  the  GI  value  is  currently  used  instead 
of  the  RHOI. 
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4.44  THE  CHARGE  STABILIZED  POISSON  ITERATION 

The  Poisson  equation  can  be  written  dlnensionlessly  as 
-V2*  -  L-2  (n.  -  nfi)  (1) 

where 

t  -  eV/kT,  L2  -  kT/N_  e2h2  .  x2/h2 
oo 

is  the  dimensionless  Debye  length,  NQ  is  the  ambient  density,  n^  - 

N./N  ,  n  -  N  /N  ,  and  the  Laplaclan  Is  also  normalized  by 
}  o  e  e  o 

h  .  The  calculation  of  n.  and  n  is  discussed  in  Section  4.43. 

i  e 

POLAR  solves  this  equation  on  its  discrete  mesh  of  uniform  spacing  h, 
using  the  finite  element  method  described  in  Section  4.21. 

The  traditional  approach  to  the  solution  of  equation  (1)  has 
been  an  explicit  iteration  of  the  form 

-vV  .  l-J[n1(*v-1)  -  n^*-1)]  (2) 

where  v  is  the  Iteration  Index,  and  the  charge  density  is  determined 

using  the  potentials  of  the  previous  Iteration.  This  method  can  be 

shown  to  be  unstable  (ref.  4-2)  when  the  Debye  length,  x,  becomes 

small  with  respect  to  other  scale  lengths  of  the  problem.  This  can  be 

understood  by  considering  that  a  smooth  potential  variation  over  a 

2 

distance  of,  say,  1000  x,  would  require  a  smooth  V  i  (the  'second 

derivative')  which  is  in  turn  given  everywhere  by  the  charge  density. 

But,  maintaining  a  smooth  charge  density  distribution  is  difficult 

when  any  errors  in  determining  (n  -  n. )  are  multiplied  by  a  huge 
_2  ®  ' 

L  .  There  is  one  effective  remedy  to  this  dilemma  due  to  Parker 
(ref.  4-2),  but  the  process  reported  here  appears  to  be  more  efficient 
in  the  short  Debye  length  limit.  This  method  involves  the  combination 
of  two  concepts.  One  uses  a  partial  implicitization  of  the  repelled 
density  (nfi,  here)  (ref.  4-3).  The  other  simply  reduces  the  charge 
density  to  an  acceptable  level  whenever  the  first  method  is  inadequate. 
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Suppose  a  plasma  of  ambient  density  NQ  and  temperature  T 
consists  of  Boltzmann  electrons,  (r )  -  N  exp($(r))  and  ions  of 

4-  “  0 

known  density  N.(r)  =  Nq  n..(r).  The  normalized  charge  density 
is  then  given  by 

q(r,4v(r))  -  L~2  [ni (r )  -  e.cp  (*v(r))3  (3) 

Equation  (3)  may  be  linearized  about  the  previous  potential  iterate 

q(«v)  -  q(iv_1)  +  q'U”-1)  *  (*v  -  «v'1) 

where  q'  *  aq/a^,  and  the  r  dependence  has  been  dropped  for  clarity. 
With  this  expression  we  may  write  the  implicit  Poisson  iteration  scheme 

wV  -  q •Wv-1)  *  *v  .  qdT1)  -  q'U'-1)  *  t'~1  (4) 

Though  it  is  not  immediately  obvious,  the  implicit  character  of 
(4)  makes  it  more  stable  than  scheme  (2).  This  can  be  understood  by 
realizing  that  in  equation  (3)  the  electron  density  was  treated  as  an 
independent  variable,  whereas  in  (4)  the  electron  density  is 
determined  simultaneously  with  the  potential,  both  being  consistent 
with  the  ion  density. 

The  finite  element  approximation  (Section  4.21)  to  (4)  produces 
the  matrix  equation 

£  (W(6)  -  S,(e)  V(e))  *  Pv  *  S  -  V{e)  *  ^v~1  (5) 

e 

where  S  is  derived  from  q  by  the  following  analysis: 

For  L  >  1,  S  Is  simply  the  total  charge  associated  with  each 
node,  q.  However,  for  L  «  1,  numerical  noise  and  features  like  a 
sheath  edge  which  may  span  only  a  few  x,  become  incorrectly  amplified 


»  *  « 


v*v-v»y 
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when  the  q  determined  at  a  point  becomes  multiplied  by  the  entire 
nodal  volume.  When  it  is  not  possible  to  reduce  the  zone  size, 
stability  can  be  preserved  by  replacing  Q  (and  Q')  with  a  reduced 
value  S  (S')  which  is  calculated  to  be  the  maximum  allowable  charge 
for  the  element.  Because  of  the  artificial  amplification  argument,  S 
is  often  the  more  realistic  total  for  an  element.  Before  deriving  S, 
we  define  the  barometric  potential  ^  -fcn(n^)  which  is  the 
potential  for  which  Q  «  0  and  note  that  it  is  important  that  S  >  Q  as 
t  »  if  quasineutral  regions  are  to  be  modeled  correctly.  To 
determine  S,  consider  a  capacitor  with  potential  difference 
(4b  -  0).  area  h  ,  and  a  separation  of  h.  The  charge  qc  on  this 
capacitor  is  given  by 

c  h2 

qc  «  CaV  *  -  4)kT 

In  the  units  of  our  previous  q;  q£  becomes 

qM  *  <*Ub  -  t)  •  «(*b  -  t) 

which  is  the  maximum  allowablte  charge  per  element,  with  the  parameter 
o,  adjusted  to  insure  that  qM  is  maximized.  Thus  at  each  node,  we 
choose  for  the  charge 

I  S  |*  min  ( |qM|,  |  q  |) 

with 

.  -o  for  S  -  qM 

s<  ■  L 

I  L  expd  for  S  -  q 

Actually,  S  and  S'  are  smoothed  in  POLAR  to  decrease  numerical 
noise  and  spatial  potential  oscillations.  This  involves  forming  the 
linear  screening  term 


,  *  ,  ■  »  '  *  »  *  ■  i  »  •  * 

'  if  _  a  _  f.  •  _  r. 


SCRN 


3  (2  •  S’(?)  +  5') 
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where 


3'  -Ej  V(I)  •  S(^( I) ) 

where  I  indexes  the  nodes  of  an  element  and  V ( I )  is  a  nodal  volume 
normalized  by  a  cubic  element  volume  of  one;  similarly  for  i>.  Also 
smoothed  is  the  nodal  cherge  Q(I), 


Q( I)  (2  -S(?)  ♦  S(0( I)) )  . 


Additionally,  POLAR  can  cutput  the  value  S(tf)  as  QUSD,  the  element 
centered  charge  actually  chosen  by  this  algorithm. 

_ ip\ 

Finally,  the  Q( I ) ,  and  SCRN  are  used  for  S  and  S1^  in  Eq. 

(5). 


The  effect  of  this  algorithm  is  this:  If  a  problem  has  been 
specified  where  a  boundary  potential  would  be  screened  in  less  than  a 
zone  or  two  (the  limit  of  any  code's  resolution),  sufficient  sheath 
charge  will  be  redistributed  so  as  to  allow  the  potential  to  be 
screened  over  the  minimum  number  of  zones  that  are  consistent  with 
stability. 

The  charge  stabilization  algorithm  is  effected  by  the 
subroutine,  QSELT,  and  QSCRN  which  are  further  described  in  Section 
5.50.  Tests  of  this  method  are  presented  in  Appendix  C. 


W 
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CHARGING  MODEL 


4.51.  CIRCUIT  MODEL 

POLAR's  circuit  model  was  Introduced  In  Section  3.40.  Here  we 
describe  the  details  of  the  time-integration  of  the  basic  charging 
equation,  3.40-1,  repeated  here. 

I(t)  -  V(t)  -  o  V(t) 

where  I  is  current,  C  capacitance,  a  conductance,  and  V  is  surface 
voltage.  We  first  difference  this  equation,  evaluating  the 
conductance  term  at  the  advanced  time  (Implicit)  and  the  current  at 
the  retarded  (explicit)  time. 

(V(t2)  -  v(tx)) 

£  - cr  V(t2)  -  I(tl) 

or 

+  o  *  (V(t-)  -  V(t.))  -  I(t,)  -  a  V(t,) 

•*»  Ai  ^  M  *  A#  A  A*  A*  A 

Section  3.40  explored  the  difficulties  associated  with  the 
explicit  current  dependence.  The  Implicit  approach  replaces  I(tj) 
with  I(t2),  approximated  as 

HV(t2))  -  Kvftj))  *  *  (v(t2)  -  v(tj)) 
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Substituting,  we  get  the  implicit  formulation 

•  (v(t2)  -  V(t1)J  -  I(t2)  -  o  V(tx) 

(4.51-1) 

The  dl/dV  term  stabilizes  the  problem  by  increasing  the  matrix 
entries  on  the  diagonal.  Physically,  the  al  ( surfaced )/aV  (surface  i) 
will  be  non-positive  since  surfaces  charge  more  slowly  as  the  voltage 
decreases  (becomes  more  negative).  Currently,  no  surface  to  surface 
interactions  are  included  so  the  current  derivative  matrix  is  diagonal. 

Unfortunately,  due  to  the  complexity  of  the  plasma  interaction, 
the  dl/dV  in  Eq.  (4.51-1)  is  not  trivial  to  evaluate;  so  we  must  use  a 
predictor-corrector  type  approach.  We  may  omit  the  dl/dV  term  from 
(4.51-1)  to  return  to  the  explicit  form,  which  may  be  solved  for  an 
estimate  of  V(t2).  Anticipating  the  possible  instability  of  the 
explicit  form,  the  aV  from  t^  to  t2  is  limited  by  the  input 
quantity  DVLIM.  With  this  new,  albeit  rough,  estimate  of  V(t2)  we 
could  run  a  complete  Poisson  current  sequence  to  get  a  aI  estimate. 

But,  because  of  the  expense  of  a  complete  Poisson  current  step,  we 
leave  the  ion  currents  constant  (otherwise  a  particle  pushing  step 
would  be  required),  and  obtain  aI  from  the  electron  current  algorithms 
alone  (4.50).  This  will  provide  an  estimate  of  aI/aV  sufficient  to 
solve  (4.51-1)  implicitly  for  V(t2). 

To  discuss  the  solution  to  Eq.  (4.51-1),  we  abbreviate  it  as 

M  .  AV  .  R  (4.51-2) 


where  M  include  the  capacitance,  conductance  and  dl/dV  matrices.  When 
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the  number  of  vector  components  Is  not  too  great  (<1000),  we  have 
found  the  Incomplete  Cholesky  Conjugate  Gradient  (ICCG)  method  to  be 
an  efficient  means  of  solving  (4.5 L— 2)  (see  Section  4.30). 

Experience  has  shown  that  IC-6  is  most  effective  when  M  Is 
diagonal  or  nearly  diagonal  (dlagcnal  elements  »  off  diagonal 
elements).  To  see  how  M  may  be  Improved,  write  (4.51-2)  as 

m 

(Mp  M2,  —  Mc)aV  -  R  (4.51-3) 


If  surface  1  connects  to  Infinity  (conductor  0)  and  conductor  C,  and 
we  consider  only  the  capacitance,  we  would  have 


"C10 


M-i  ■ 


V 

I 


1C 


and  Mr 


1C 


-C 


CO 


where  C^c  »  C^Q,  CCQ.  (That  this  Is  a  legitimate  example,  see 
the  complete  sample  problem  worked  in  Appendix  A.)  It  Is  the  off 
diagonal  entries  of  C1C  that  need  to  be  removed.  This  is 
accomplished  by  transforming  (4.51-3)  to 


aVi  -  aVc 


(Mj,  M2  ,-,  Mc  +  Mx) 


aV, 


A  column  transformation  for  each  surface  will  "clean  up"  the  upper 
right  triangle  of  M,  while  producing  a  transformed  potential  vector 
where  surface  potentials  have  been  replaced  by  the  potential 
difference  between  the  surface  and  the  underlying  conductor.  The 
lower  left  triangle  of  M  Is  diagonalized  and  symmetrized  to  the  upper 


by  similar  row  additions  with  corresponding  transforms  of  JR  on  the 
right  hand  side.  Cjrrents  (in  JR)  to  surfaces  remain  unchanged,  but 
currents  to  conductors  are  replaced  as 

!C  *  rc  "  h 

S 


where  the  sum  is  over  all  surfaces  connected  by  capacitance  or 
conductance  to  the  main  conductor,  C;  other  conductors  are  treated  as 
surfaces  and  referenced  to  C, .  The  a  and  V  on  the  right  hand  side 

ft  ^ 

are  treated  identically  to  o,  C  and  V  on  the  left.  Finally,  the  dl/dV 

R:  at 

matrix  is  calculated  for  the  transformed  I  and  V  guaranteeing  that  it 
will  be  diagonal. 

Another  feature  of  POLAR's  charging  model  will  change  the 
previous  transformations.  This  happens  when  NTERAK  recognizes  that 
the  lowest  estimate  of  the  ion  flux  (ambient  ram  conditions  including 
shadowing)  exceeds  the  greatest  estimate  of  the  primary  energetic 
electron  flux,  and  the  surface  potential  is  near  zero.  Physically,  if 
kthe  magnitude  of  the  surface  potential  drops  to  near  -k  Tg  cQol 
(typically  1  volt)  the  flux  of  cool  electrons  will  prevent  the  surface 
from  charging  positive.  These  millivolt  sensitivities  are  difficult 
to  follow  in  a  code  that  is  concerned  with  kilovolt  charging.  Thus, 
such  a  surface  will  be  spotted  (this  Is  currently  implemented)  and 
have  its  potential  fixed  at  -k  Tg  c00^  for  the  upcoming  charge  cycle. 

This  will  also  occur  when  a  presently  nonexistent  routine  in 
NTERAK  will  recognize  the  required  conditions  for  a  surface's 
potential  to  be  controlled  by  a  E  .  if  -  0  condition  on  the  surface. 
This  may  occur  when  a  secondary  or  photoelectron  space  charge  density 
becomes  large  enough  to  form  a  small  barrier  to  the  low  energy  portion 
of  the  emitted  spectrum.  Such  a  surface  will  be  flagged  and  get  Its 
potential  floated  In  the  Poisson  solution  according  to  the  E  .  n  ■  0 
condition,  while  being  held  fixed  during  the  circtiit  solution. 


This  fixing  Is  not  compatable  with  the  V  transformation,  so 
POLAR  Is  forced  to  solve  the  circuit  model  with  the  original 
equations.  Accuracy  does  not  suffer,  but  ICCG  will  require  more  time 
for  the  same  level  of  convergence. 

Other  conditions  will  also  arise  that  will  require  a  surface 
cell  to  be  held  at  a  fixed  potential. 


4.5-6 

4.52  ELECTRON  CURRENTS,  PRIMARY,  SECONDARY 

The  POLAR  electron  environment  is  described  in  Sections  3.15  and 
3.31.  This  section  explains  the  integration  procedures  used  to  obtain 
the  net  electron  currents  to  a  surface  due  to  primary,  secondary,  and 
backscatter  electrons.  Further  information  concerning  the  code 
mechanics  and  subroutine  relations  can  be  found  in  Section  5.70. 

4.52.1  SECONDARY  ELECTRONS 

The  secondary  electron  yield  coefficients  used  in  this  section 
(4.52.3,  4.52.4,  4.52.5)  are  calculated  using  the  proven  techniques 
and  theories  developed  for  NASCAP.  The  reader  is  currently  referred 
to  Reference  4-1  for  a  description  of  these  methods. 

4.52.2  BACKSCATTER  ELECTRONS 


See  Section  4.52.1. 


4.52.3 


INTEGRAL  OF  THE  MAXWELLIAN  DISTRIBUTION 


The  current  of  electrons  of  charge  q  to  a  surface  at 
voltage  V  due  to  the  Maxwellian  portion  of  the  spectrum  is  given  by 

2»  t/2 

- — 9EL-  f  d#  /  sine  cose  de  g(E,  ip  (M)) 

M  (kT)S  JQ  J0 


*  I  K  dK  exp[-(qV  ♦  K)/kT] 

•'L 

L  «  max(-qV,  0) 

The  lower  kinetic  energy  limit  L  Is  chosen  to  exclude  orbits 
that  cannot  energetically  connect  to  Infinity.  The  function  g  is  a 
function  of  the  pitch  angle  (see  Section  3.31)  and  total  particle 
energy  E.  We  are  concerned  here  with  the  Integral  over  kinetic 
energies,  so  the  angle  Integrals  will  be  performed  assuming  g  to  be  a 
constant  function  of  value  unity,  so  as  to  give  the  correct  current 
for  an  Isotropic  flux. 

The  flux  of  electron  generated  secondary  and  backscatter 
electrons  Is  obtained  by  adding  a  yield  function  Y(K,6,e)  to  the  above 
integrals  (Section  3.33).  POLAR  presently  replaces  Y  with  an  angle 
averaged  Y(K)  for  the  isotropic  case.  Thus 


K  e"K/kT  .  Y  (K)  .  dK 


where  the  primary  current  J,  is  obtained  by  setting  Y  ■  1. 


For  arbitrary  Y,  the  Integral  must  be  performed  numerically.  It 
Is  also  desirable  to  divide  up  the  spectrum  In  a  manner  that  covers 
the  larger  fluxes  at  low  energies  without  Ignoring  the  high  energy 
tall  of  the  Maxwellian  spectrum.  A  logarithmic  spacing  is 
accomplished  by  the  substitution 

K  *  -kT  lnx  . 

Thus  we  have 

xu 

JMS  *  ^  f  ^(K(>))  lnx  dx 
/xl 

-L/kT 

where  xu  «  e  ,  and  xl  =  0.  Since  lnx  is  singular  at  x  ■  0,  the 
lower  limit  is  set  to  xl  =  0.01  *  xu  and  the  omitted  portion  of  the 
spectrum  approximated  by  xl  *  ln(x).  The  summation  is  performed  using 
Simpson's  rule  and  20  points. 


4.52.4 


INTEGRAL  OF  THE  POWER  LAW  DISTRIBUTION 


The  discussions  of  angular  dependence  In  the  flux  Integral  given 
In  Section  3.31  and  4.52.3  also  apply  her*:,  so  we  will  limit  this 
treatment  to  the  energy  Integral 

KU  _ 

(A)  J  -  aq  f  Y(k)  .  (K  +  qV)"(o+1)  K  dK 

Al 

where  J  Is  current,  Y  Is  secondary  or  backscatter  yield,  K  is  kinetic 
energy,  a  is  a  constant  (a  -  *A  for  Isotropy),  q  is  charge,  and  V  is 
surface  potential.  For  the  limits  we  choose 

KL  -  MAX  (0,  EL  -  qV) 

KU  -  MAX  (EU,  EU  -  qV) 

where  EL  is  a  physical  cutoff  (default  ■  00  eV)  and  EU  is  imposed 
sufficiently  high  as  to  avoid  significant  error  (default  « 

1  x  109  eV). 


The  first  step  Is  the  transformatio  i 
X  -  K  +  qV  , 
which  gives 


XU  _ 

J  -  aq  f  Y (K( X ) )  .  [X"a  -  qV  X-(a+1)]  dX 

•Al 

where  XL  •  max(qV,  EL)  and  XU  -  max(EU  +  qV,  EU). 

Since  o  can  be  as  large  as  3.0,  this  spectrum  is  strongly  peaked 
towards  lower  energies,  which  implies  that  a  nonuniform  spacing  of 
Integration  points  Is  desirable.  This  is  easily  accomplished  by  the 
substitutions. 


1 


•  -V: 


x  ■  y  ' '  for  the  first  term,  and 
x  ■  z”^°,  for  the  second  erm 


of  the  previous  integral,  which  leads  directly  to 


aq 


[yu  _  zu  _ 

■h  f  *<* 

-'yl  Jl\ 


,1-0 


where  yl  -  xl  ,  etc.  Notice  that  these  choices  produce 
integration  weights  of  value  unity.  The  numerical  integration  is  done 
over  20  points  spaced  evenly  in  y  and  z.  These  transformations  are 


very  strongly  biased  towards  the  lower  energies  thus  the  upper  cutoff 

g 

was  chosen  quite  high  (1  x  10  eV}  to  force  good  coverage  of 


Intermediate  energies  where  Y  might  be  peaked. 


A  method  with  variable  bias  was  also  Investigated.  This 
utilized  for  Eq.  (A),  the  substitution 


K  -  *-1/8  -  S 


dK  .  -  i  dx  .  w(x)  dx 

M 


This  method  has  the  ability  to  adjust  the  bias  with  s,  and  center  the 
integration  points  about  an  energy  related  to  S.  This  method  is 
inherently  slower  due  to  the  calculation  of  the  weights  w(x),  and 
appeared  to  offer  ro  great  advantage  over  the  previous  method.  It  is 
not  presently  used  by  POLAR,  but  remains  an  option. 


4.52.5 


INTEGRATION  OF  GAUSSIAN  DISTRIBUTION  ELECTRONS 


This  treatment  Is  limited  to  the  energy  Integral  of  the  Gaussian 
electron  distribution.  The  angular  dependence  has  been  integrated 
assuming  Isotropy  as  discussed  in  Section  3.31  and  4.52.3.  From 
Section  3.31,  the  integral  of  Interest  is 

00 

(A)  J$  -  wB  f  Y(K)  exp[-(K-K0)2/«2]k  dK  . 

Jo 

As  in  the  previous  Sections  4.52.1  and  4.52.2,  the  inclusion  of 
the  angle  averaged  yield  function  Y(K)  will  make  J  the  current  of 
backscatter  or  secondary  electrons  (see  Section  3.33);  with  the 
omission  of  Y,  J  becomes  the  Incoming  primary  flux. 

This  integral  is  performed  numerically  by  an  8  point  Hermit 
integration  scheme  (Ref:  Handbook  of  Mathematical  Functions,  U.  S. 
Dept,  of  Commerce,  National  Bureau  of  Standards,  Applied  Math  Series 
No.  55,  pp.  924,  1964). 


The  weights  and  absissa  are: 


i 

xi 

w(x1) 

1,5 

+0.38119 

6.61147  x  10-1 

2,6 

+1.15719 

2.07802  x  10-1 

3,7 

+1.98166 

CSJ 

f 

O 

H 

X 

00 

o 

N 

• 

4,8 

+2.93064 

1.99604  x  10~4 

Equation  (4. 52.3— A)  can  thus  be  approximated  by 
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(B)  J$  -  *B  2  w^xi)  •  Y(Ki>  *  exp[-4K?/«2]  .  Ki  .  0(K  .-KL) 
1-1 


where 


K.  .  K0  +  X.  *  a 
aK  •  —  *  a 


0(Ki  -  K)  (  =  1  for  Ki  -  KL  >  0 


0  for  K. 


-  KL  <  0. 


KL  is  chosen  as  max(0,  -qV)  which  excludes  energetically  trapped 
orbits. 

Js  as  given  by  B  has  the  undesirable  property  of  being 
discontinuous  with  respect  to  K  due  to  thee  function.  This 
feature  can  be  removed  by  calculating  J  with  the  same  scheme  (omitting 
Y).  J  will  be  discontinuous  at  exactly  the  same  values  of  K  as 
We  can  then  form  a  smooth  as 


*  Js  0 

S  *  T  ■  Ja 


where  J  is  the  analytic  solution  to  the  primary  flux  integral 

a 

derived  below: 


K  -  K. 


0a  -  qA 
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4.53 


ION  SURFACE  CURRENTS 


For  the  attracted  ion  currents,  POLAR  tracks  particles  from  a 
sheath  surface  to  an  object  surface.  Experience  has  shown  that  if 
surface  currents  are  simply  accumulated  from  incident  particles,  the 
currents  are  noisy  and  lead  to  non-physical  charging  behavior. 

Numerous  reasons  exist  for  this  noise:  tracking  errors,  potential 
field  Irregularities,  too  few  trajectories,  etc.  While  these  problems 
have  all  been  studied.  It  remains  desirable  to  have  a  smoothing 
algorithm  for  the  Ion  surface  currents. 

The  Ion  currents  to  be  smoothed  are  derived  from  the  “dead-list" 
of  particles  produced  from  the  particle  pushing  module  CURREN  (4.40). 
This  dead-list  contains  the  particle's  weight,  final  position,  final 
velocity,  and  Initial  energy  and  the  surface  the  particle  landed  on. 

To  speed  up  the  surface  current  calculation  and  to  reduce  noise,  the 
dead-list  is  condensed  to  the  SRFC  list,  ordered  by  surface  number. 

The  particle  weights  are  added  since  they  represent  the  ion  current. 
The  particle  weights  are  also  used  to  weight  the  averages  of  spatial 
and  energy  information.  An  average  position  on  the  cell,  angle  of 
incidence,  and  particle  energy  are  calculated  as  follows: 


N 


2  wk  Xik 


k.l 


where  wt  Is  the  weight  (current  contribution)  of  particle  k,  N  is 
the  number  of  particles  striking  the  surface,  and  is  the  1 
component  of  the  position  vector.  The  average  velocity  and  energy  are 
found  similarly. 
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The  adopted  smoothing  algorithm  Is  a  two-step  process  wherein 
the  raw  surface  currents  are  distributed  to  nodes,  and  then  re¬ 
distributed  back  to  surfaces.  This  simple  algorithm  Is  illustrated  In 
Figure  4.53/1.  Given  an  averaged  particle  at  the  point  P,  on  surface 
a,  its  current  is  shared  In  a  bilinear  fashion  to  the  vertices  (nodes) 
of  the  surface,  producing  a  node  current  1^. 


Figure  4.53/1. 


Since  two  different  types  of  surface  occur,  triang.es  and 
rectangles,  two  different  methods  are  used.  For  triangles,  the 
bilinear  weight  of  a  corner  is  area  of  the  triangle  opposite  the 
corner  over  the  total  surface  area  (see  Figure  4.53/2). 


| (A-C)  x  (B-C) | 


where  w$n  is  the  bilinear  weight,  J  is 
the  particle  posit- on,  and  s  and  a  refer 
to  surface  and  node. 


Figure  4.53/2.  Bilinear  weighting  of  triangular  surfaces 
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For  rectangular  surfaces,  the  particle  position  divides  the 
rectangle  into  four  smaller  rectangles.  Then  the  weight  is  found  by 
dividing  the  area  of  the  opposite  small  rectangle  by  the  area  of  the 
surface  (see  Figure  4.53/:), 


C  0 


[  Figure  4.53/3.  Bilinear  weight  (wb$a)  of  a  rectangular  surface. 

E 

‘  Thus  we  have  for  Figure  4.53/1 

i 

r  Al1  “  wba1  *  SRFC(a) 

i  where  the  a  Indicates  that  this  Is  a  current  Increment.  The  complete 

|  I.  is  never  formed. 

| 

[:  The  next  step  Is  to  share  the  node  current  back  to  the 

h  surfaces.  We  may  derive  a  simple  sharing  formula  by  forming  a  nodal 

I  current  density,  aJ^  as 

»  ■  aI^/A,j 


where  Is  the  area  associated  with  node  1; 


m. 


!  ^  *  •  K 

m 

m 


V.-Y 

.  •  .  %  . 
V  v. 


Ai  *  S  Vnj 

j«l 

where  the  Aj  are  areas  of  the  m  surface  cells  adjoining  node  1,  and 
nj  Is  the  number  of  vertices  of  each  adjoining  surface  cell.  A^ 

Is  bounded  by  the  dashed  line  In  Figure  4.53/1. 
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The  aJ^  Is  redistributed  to  surfaces  adjoining  node  1  In 
proportion  to  the  area  each  contributed  to  the  rode  area.  Thus, 
surface  b  would  receive  a  final  surface  current  Increment  alb. 


Finally,  we  may  combine  the  three  previous  equations  Into  a  node 
to  surface  weight  factor  ws^.  Thus  the  final  surface  current, 
alb.  Is  obtained  from  the  Intermediate  node  current  al^  as 

Alb  “  ws1b  Alb 
Abnb 

ws1b  "  “m^j - 

E  V"j 

j-1 

This  process  Is  performed  for  each  surface  adjoining  the  1  nodes 
of  surface  a.  The  final  smoothed  surface  currents  are  accumulated  as 
this  overall  process  Is  repeated  for  all  the  surfaces  of  the  object. 

An  Important  feature  of  this  algorithm  Is  that  a  uniform  flux  to 
an  Irregular  object  will  produce  surface  currents  exactly  proportional 
to  the  surface  areas  as  would  be  expected.  To  see  this,  consider  the 
quasisphere  of  Figure  4.53/1.  This  object  has  three  types  of 
surfaces,  with  areas  S,  R,  and  T;  and  only  one  type  of  node.  A 
uniform  flux  of  particles.  If  tracked  accurately,  will  produce  uniform 
node  currents.  Summing  w^j  *  around  the  vertices  of  a  surface, 
we  see  that  the  resulting  surface  current  will  be  proportional  to  the 
surface  area,  and  Inversely  proportional  to  the  factor  In  the 
denominator  of  the  expression  for  ws^j,  which  Is  constant  for  our 
example.  The  ws^j  are  properly  normalized.  This  can  be  easily  seen 
In  our  example  by  summing  the  ws1{  around  a  node; 


since  the  Indices  k  and  j  range  over  the  same  surfaces. 

At  our  present  stage  of  development,  we  are  simply  dividing  and 
redistributing  the  node  currents  according  to  the  relative  areas  of 
adjacent  cell,  but  provisions  have  been  made  for  a  more  comprehensive 
treatment.  For  example,  spatial  and  electrical  Information  could  be 
used  to  avoid  non-physical  sharing  of  surface  currents;  such  as 
redistributing  Ion  currents  to  a  surface  with  a  large  positive 
potential,  or  around  corners. 
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5.  POLAR  CODE  STRUCTURE 


This  chapter  Is  designed  to  provide  Insight  Into  the  Internal 
workings  of  POLAR.  Whenever  possible,  actual  subroutine  names  and 
variable  names  will  be  used. 

5.10  TOP  DOWN  VIEW 

POLAR  Is  actually  five  standalone  programs  that  communicate 
through  a  minimum  number  of  files.  This  approach  allows  a  high  degree 
of  flexibility  In  model  building  while  minimizing  the  amount  of 
unnecessary  computing.  These  programs  are  VEHICL,  ORIENT,  NTERAK , 
SHONTL,  and  PLOTTR.  Their  functions  are  described  below.  Whenever 
scratch  files  are  used,  they  are  assigned  and  disposed  of 
automatically.  In  general,  only  two  files  are  needed  to  allow 
communication  between  the  four  modules. 

VEHICL  Is  the  object  definition  program.  It  utilizes  much  of 
the  user-oriented  object  definition  procedures  developed  at  S-CUBED 
for  NASCAP.  With  VEHlCL,  one  uses  a  variety  of  basic  building  blocks 
to  define  the  vehicle  to  be  modeled  on  a  variable  sized  3-D  grid.  One 
also  defines  all  of  the  surface  properties  and  underlying  conductors. 
VEHICL  then  completes  the  vehicle  electrical  model  and  creates  a 
number  of  "connectivity"  tables  to  accelerate  NTERAK  execution.  This 
Information  is  written  on  two  files,  11.  and  19.,  which  carry  this 
Information  to  the  other  modules. 

ORIENT  Is  the  attitude  control  program.  User  Input  Is  simply 
the  dominant  plasma  flow  direction  viewed  from  the  vehicle.  If 
necessary,  ORIENT  will  rotate  the  vehicle  and  object  grid  so  as  to 
keep  the  wake  direction  predominantly  In  the  *2  direction.  ORIENT 
will  also  restructure  most  of  file  11  so  that  It  will  have  the  correct 
sllceabllity.  The  restructured  file  11.  contents  will  either  be 
copied  back  to  file  11.,  or  output  to  a  new  file  11S,  where  S 
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represents  a  user-supplied  suffix.  A  set  of  six  US  files  would 
catalog  all  of  the  possible  coordinate  orientations,  and  allow  for  all 
Mach  vectors. 

NTERAK  Is  the  biggie  that  actually  calculates  the  vehicle-plasma 
Interaction.  The  Internal  workings  and  I/O  are  the  subject  of  most  of 
this  document,  but  It  should  be  emphasized  that  once  a  Mach  vector  has 
been  defined,  the  extended  computational  grid  will  be  "burned"  Into 
the  11S  file.  The  11S  maintains  a  complete  restart-contlnue 
capability,  but  a  fresh  file  must  be  used  If  the  Mach  vector  Is  to  be 
changed . 

SHONTL  Is  the  machine  Independent  plotting  package.  It  is 
designed  to  be  run  seml-lnteractlvely.  By  this  we  mean  that  plotting 
directives  are  entered  by  a  "keyword"  input  system  that  function  in 
both  batch  and  Interactive  environments ,  but  nothing  Is  plotted  until 
the  session  Is  concluded  and  PLOTTR  Is  executed.  This  somewhat 
cumbersome  procedure  is  necessary  to  maintain  the  machine  independence 
of  SHOHTL.  SHONTL  can  be  used  after  any  of  the  previous  three  modules 
to  graphically  check  the  work  progress  at  any  given  stage.  SHONTL 
reads  from  file  11,  and  communicates  with  PLOTTR  through  file  2. 

PLOTTR  is  the  machine-dependent  plotread  package  that  reads  the 
generic  pen-move  and  vector  commands  written  on  file  2  by  SHONTL,  and 
translates  these  commands  to  the  local  graphics  package. 
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5.13  NTERAK 

The  program  NTERAK  Is  the  heart  and  brain  of  POLAR.  It  contains 
all  of  the  physical  models  and  computational  techniques  described  In 
the  previous  chapters.  The  purpose  of  this  section  Is  to  outline  the 
structure  of  NTERAK.  Further  desrrlptlons  of  the  functional  content 
of  the  more  Important  routines  cai  be  found  In  the  Indicated 
sections.  For  clarity,  utility  routines* have  been  omitted  from  the 
following  chart: 

Level  1 


NTERAK: 


Main  executive  routine 
Calls  INPUT 
SPACE 
PHASON 


Level  2 


INPUT: 


SPACE: 


PWASON: 


Controls  the  keyword  Input  of  options  and 
parameters  (6.40)  and  opens  files  9  and  11  (5.30), 
Set  up  the  computational  grid  (5.20). 

Calls  MRBUFF. 

Control  of  the  Poisson  Iteration  and  tests  for 
convergence  (4.21.5). 

Calls  IONDEN 
Calls  CONGRD 


Level  3 


MRBUFF:  Initializes  the  vector  properties  that  effect  their 

paging  from  core  to  disk. 

IONDEN:  Controls  the  calculation  of  the  Ion  densities 


(3.20,  4.40). 


CONGRD:  Performs  the  conjugate  gradient  calculation  and 

tests  CGM  convergence  (4.21.1). 


loop 


on 


Calls  COPROD 
URSETO 
COPROD 
PUTDAT 
RUPDAT 
UllPDAT 


Level  4 


COPROD:  Called  first  to  calculate  JJ  .  £  to  estimate  initial 

residuals,  r  (4.21.1)  and  to  calculate  the  linear 
screening  for  the  Poisson  iteration  (4.46). 


URSETO: 
PUPDAT: 
RUPOAT: 
UUPDAT : 


Loop  calls  calculate  M  .  U 

A* 

Calls  BUFCLR 


BUFSET 

GRID 

PAGER 

XYGRID 

CURCEL 

ZBNDRY 

VERTIO 

YBNDRY 

ELEMNT 

XBNDRY 

DC VC EL 

GETSCR 

FORFIL 

PCUBES 

BACFIL 

ECUBES 

Calculate  r  .  r  and  initialize  u  (4.21.1). 
P  equation. 


r  equation. 


u  equation. 
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Those  level  5  routines,  called  by  COPROD  that  are  import 
understand  are  discussed  in  5.20  on  the  displaced  grid  system. 


5.20  SLICE  6RI0  SYSTEM 


The  displaced  slice  grid  system  Is  designed  to  provide  the 
computational  space  In  which  to  solve  Poisson's  equation  for  the 
shuttle  orbiter,  Including  a  wake  extending  many  spacecraft  lengths. 
Hence  the  grid  must  continue  for  an  arbitrary  length  in  the  plasma 
flow  direction. 

To  facilitate  this,  the  grid  is  composed  of  a  variable  number  of 
XY  slices,  stacked  along  the  Z  axis,  rather  like  a  loaf  of  sliced 
bread.  Figure  5.20/1  Illustrates  a  displaced  grid  system  along  with  a 
number  of  important  parameters.  Objects  are  defined  on  a  rectangular 
NXOB  x  NYOB  x  NZOB  grid  (5.11,  6.20).  In  all  cases,  the  object  grid 
will  have  been  rotated  by  ORIENT  such  that  the  dominant  component  of 
the  plasma  flow  vector  VMACH  Is  oriented  along  the  +Z  direction.  As 
shown  in  the  figure,  the  grid  follows  VMACH  by  stepping  +1  unit  in  the 
X  and  Y  direction  every  1DELX  and  1DELY  mesh  units  along  the  Z 
direction  (the  +1  step  follows  the  sign  of  1DELX  or  1DELY).  These 
step  intervals  are  calculated  in  the  routine  N. SPACE  according  to  the 
relation  (FORTRAN) 

IDELX  -  VMACH (Z) /VMACH(X)  +  0.5 

(y)  (y) 

where  the  +  follows  the  sign  of  VMACH(X).  Since  IDELX  is  an  integer, 
the  0.5  centers  the  velocity  ratio  between  integral  increments. 

The  computational  grid  must  enclose  the  object  grid  with  a 
minimal  amount  of  wasted  space.  To  accomplish  this,  the  routine  SPACE 
references  the  two  grids  at  the  point  shown  in  Figure  5.20/1,  then 
calculates  the  NXGRTH(NYGRTH)  necessary  to  fit  the  grids  together. 

When  the  user  anticipates  the  need  for  additional  work  space,  the 
INPUT  parameters  NXADON  and  NYADON  can  Increase  the  X-Y  grids  without 
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Figure  5.20/1.  A  X-Z  cut  of  a  typical  NTERAK  computational  mesh 

showing  the  object  definition  grid  and  the  computed 
(NXGRTH,  IDELX)  and  user-specified  (NXADON,  NZADON, 
NZTAIL)  grid  parameters. 
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requiring  a  redefinition  of  the  object  space.  The  6RTH  and  ADON 
parameters  are  Included  Into  the  final  NX  x  NY  dimensions. 

The  computational  space  Is  characterized  by  the  following 
parameters: 

NX0BtNY0B,NZ0B  -  The  real  node  dimension  of  the 

object  grid  along  the  X,  Y,  and  Z 
directions. 

NX  -  NXOB  +  NXGRTH  +  2  x  NXADON 

■  the  real  node  dimension  of  a  slice 
along  the  X  direction. 

NY  -  NYOB  ♦  NYGRTH  +  2  x  NYADON 

NZ  -  NZOB+NZTAIL  ♦  NZADON 

The  NZADON  and  NZTAIL  are  also  Inputs  to  NTERAK  and  are 
currently  limited  to  total  a  Z  node  count  of  100.  This  limit  could  be 
extended  Indefinitely  subject  to  available  disk  storage  and  budget 
limitations.  This  last  feature  is  the  Intended  result  of  NTERAK 1 s 
data  management  system.  This  system  allows  models  to  be  constructed 
primarily  on  disk  with  the  computer  "core"  used  to  perform  arithmetic 
on  small  volumes  of  space. 
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5.21  SLICE  MACHINERY  \% 


The  grid  machinery  consists  of  routines  designed  to  move  or  page 
grid  Information  between  disk  and  core.  In  both  media.  Information 
for  each  of  the  vectors  ('p',  'r',  'u',  etc.  (4.21.1)  are  called 
vectors  even  though  they  are  scalars  at  a  particular  grid  point) 
Involved  In  a  calculation  Is  organized  Into  Individual  one-dimensional 
arrays  corresponding  to  each  X-Y  slice. 

NTERAK  distinguishes  between  two  types  of  nodes,  real  and 
virtual.  At  real  nodes  a  problem's  variables  are  truely  variables. 
Virtual  nodes  exist  as  the  outer  boundary  of  the  problem,  where  values 
are  generated  according  to  the  boundary  conditions.  There  may  be  one 
or  two  virtual  nodes  beyond  the  edge  of  a  slice  (see  Figure  5.20/1) 
depending  on  the  proximity  of  a  step.  Only  real  nodes  are  paged  in 
and  out.  Each  vector  slice  has  a  real  node  length  NX  x  NY  with  the 
assumed  convention  that  the  X  coordinate  varies  the  fastest. 
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In  order  to  relate  the  slices  to  one  another  and  perform 
arithmetic  with  minimal  confusion.  It  Is  necessary  to  adopt  a  standard 
coordinate  system.  There  are  two  possible  choices;  object  and  slice 
coordinates.  We  have  chosen  object  coordinates  as  the  primary  system, 
but  slice  coordinates  are  sometimes  required  by  lower  level  routines. 
Object  coordinates  reference  the  "least"  real  node  of  the  object  grid 
as  (1,1,1)  (see  Figure  5.20/1).  By  "least"  we  mean  the  node  for  which 
NX  x  NY  x  (Z— 1)  +  NX  x  ( Y— 1 )  +  X  is  a  minimum.  Thus  the  least  real 
node  object  coordinates  of  some  slices  may  be  less  than  zero,  while 
the  slice  coordinates  of  the  least  node  will  be  (1,1,ZSLICE)  where 
ZSLICE  numbers  from  1  to  NZ.  The  relationship  of  the  slices  to  each 
other  is  written  in  the  common  block  MESHY  by  the  routine  6RI0.  This 
block  contains  the  object  coordinates  of  the  least  real  node  of  each 
slice.  For  further  detail  concerning  subroutines  and  common  blocks 
see  Appendices  A  and  B. 


C 

£ 


I 


► 


C*, 

t. 


S: 


NTERAK's  grid  machinery  exchanges  Information  between  disk  and 
special  common  block  called  CBUF.  The  core  location  of  CBUF  Is  such 
that  Its  addresses  are  the  highest  of  all  other  data  and 
Instructions.  On  many  machines  this  allows  the  CBUF  length  to  be 
extended  or  reduced  dynamically  during  execution  to  precisely  match 
storage  requirements.  The  allocation  and  addressing  of  data  space  In 
CBUF  Is  controlled  by  three  routines  (see  Section  5.30),  W1BUFF, 
BUFCLR,  and  8UFSET.  MRBUFF  Is  called  onlj  once  from  the  level  2 
routine  SPACE  and  Initializes  the  array  VPROPS  which  contains  all  of 
the  Individual  vector  properties  that  affect  the  vector's  handling 
storage  requirement  In  CBUF  and  on  disk. 

Subsequently,  any  computational  process  requiring  vector  slice 
transfers  to/from  disk  will  first  call  BUFCLR.  BUFCLR  clears  the 
ADORES  common  block  which  contains  the  CBUF  addresses,  releases  any 
dynamical  requested  core,  and  resets  other  storage  control  variables. 

The  next  step  Is  to  call  the  routine  BUFSET,  passing  It  a  list 
of  up  to  four  vector  names  and  the  number  of  slices  that  will  be 
needed  In  core.  BUFSET  will  assign  each  vector  a  region  in  CBUF,  and 
list  this  addresse  In  the  common  ADORES.  BUFSET  may  be  called 
repeatedly  for  a  total  of  12  vectors.  For  example,  in  an  operation 
requiring  three  slices  of  'R',  'R'  would  fce  assigned  the  address 
sequence;  A,  B,  C,  A,  B,  C,  A,  B,  ...  ,  fer  all  1-NZ  slices.  The 
actual  transfers  are  effected  by  PAGER,  which  can  read,  write,  or 
read-write  slices.  Suppose  that  2,  3  and  4  were  in  core  starting  at 
the  CBUF  address  B,  C  and  A,  respectively.  If  PAGER  were  called  to 
read-write  'R',  for  slices  3-5,  'R •  slice  2  at  B  would  be  written  on 
disk,  and  slice  5  would  be  read  Into  CBUF  at  B.  The  R  slices  3  and  4 
would  remain  untouched. 
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Some  other  routines  that  ar<>  commonly  used  with  this  grid 
machinery  should  be  mentioned.  Oie  is  XYGRID,  which  looks  in  the 
MESHY  common  block  and  returns  the  X  and  Y  limits  of  a  slice  in  object 
coordinates.  The  others  are  X8NDRY,  YBNDRY,  and  ZBNORY .  These 
routines  will  take  an  element  Index  (equal  to  the  least  Index  of  its 
eight  nodes)  and  determlre  which  of  the  element's  eight  nodes  are  real 
or  virtual  (boundary  nodes).  This  Information  is  kept  in  the  array 
MBXYZ(8).  To  form  an  element  on  the  staggering  grid,  VERTIO  is  called 
to  pick  four  nodes  from  each  of  the  two  bordering  slices  totaling 
eight  vertices.  Individual  words  of  a  vector  at  a  node  are  located  in 
CBUF  by  the  statement  function  CBUFAO  (Appendix  B). 

In  retrieving  these  words,  the  MBXYZ  array  Is  consulted  to 
determine  if  a  node  is  virtual.  If  so,  the  boundary  value  (currently 
zero)  will  be  used  for  that  node. 

The  routine  GETSCR  is  a  cousin  to  VERTIO.  It  will  'GET'  or 
'REP'  the  element  centered  quantities  *GI '  or  'SCRN*.  'GI '  Is  the 
name  given  to  the  normalized  ion  densities  (3.20,  4.41),  and  'SCRN' 
refers  to  screening  factors  (4.43). 

For  further  detail?  concerning  the  function  or  use  of  this 
machinery,  the  individual  subroutine  description  in  Chapter  100  should 
be  consulted.  In  addition,  the  subroutine  COPROD  uses  all  of  this 
machinery  and  may  be  consulted  for  an  example. 


5.22  VOLUME  ELEMENT  MACHINERY 


To  Illustrate  NTERAK's  volume  element  machinery  we  will  describe 
Its  use  by  the  subroutine  COPROO.  COPROO's  function  Is  to  generate 
the  M  •  U  product  and.U  •  M  •  U  Inner  product  (4.30).  Once  slice 
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Information  has  been  accessed  and  resides  In  core  (5.21) ,  COPROO  must 
calculate  residuals,  element  by  element,  and  return  the  vector  so 
calculated  back  to  the  disk  In  slices.  These  operations  are  complex 
and  require  fairly  elaborate  machinery.  He  begin  by  offering  a  brief 
overview. 

COPROO  begins  by  reading  In  the  relevant  slice  Information, 
establishing  a  section  of  the  computational  space  In  core.  This 
volume  Is  swept,  element  by  element.  Each  element  Is  characterized  by 
the  coordinates  of  Its  lowest  Indexed  ver  ex.  The  potentials,  and 
other  vector  Information,  for  each  of  the  eight  vertices  of  a 
particular  element  are  extracted  from  the  main  /CUBF/  array  by 
VERTIO.  VERTIO  also  replaces  or  augments  array  entries  with 
calculated  vertex  Information. 

The  potentials  at  the  boundary  of  the  computational  space  are 
assumed  to  be  fixed  and  known  (presently  set  to  zero).  Hence  they  are 
not  stored  explicitly  In  CBUF.  Instead,  COPROO  examines  each  vertex 
of  each  volume  element  and  determines  If  my  be  an  Implicit  boundary. 
Those  that  do  are  fixed  at  the  boundary  p>tent1al.  VERTIO  (5.21, 
Appendix  B)  takes  the  X-Y  displacement  of  the  slices  into  account  In 
picking  out  the  vertices.  Having  set  the  potentials  at  the  vertices 
of  a  particular  element  with  VERTIO,  COPROO  calls  ELEMNT  to  look  up 
its  characteristics  In  the  list  'LTBL'.  I  TBL  Is  an  array  with  an 
entry  for  each  element  In  the  object  grid  'LTBL'.  LTBL  is  an  array 
with  an  entry  for  each  element  In  the  object  grid,  containing  the 
following  bit  coded  information  (5.23):  the  element  type,  the  number 
of  surface  cells  sharing  one  or  more  nodes  with  the  element  (NCELLS), 
the  element  orientation,  and  the  top/bottcm  flag. 


5.2-8 

The  number  of  surface  cells  (NCELLS)  sharing  nodes  with  the 
element  Is  used  to  refer  to  a  second  list,  LCEL.  If  NCELLS  Is 
non-zero,  DCVCEL  Is  called  to  decode  the  next  (NCELLS  +  1)  entries  In 
the  LCEL  (5.25)  list.  The  first  word  of  this  group  will  be  an  element 
I.D.  number  used  merely  as  a  check.  The  remaining  words  are  also  bit 
coded  with:  the  surface  cell  number,  the  N0DC00  telling  which  nodes 
are  shared  with  the  surface,  and  the  FCN  number  (4.21)  telling  which 
element  face.  If  any,  the  surface  occupies. 

If  a  vertex  or  node  Is  shared  by  a  surface  cell,  Its  potential 
Is  replaced  with  the  surface  potential  for  that  cell,  stored  in  the 
array  SVRFV,  sequentially  by  cell  number.  In  the  same  way  the 
contribution  to  the  residual  derived  from  the  shared  vertex  Is 
returned  to  the  list  SVRFR  rather  than  the  residual  vector.  Hence  the 
surface  potential sd  play  the  part  of  additional  grid  points,  or 
variables  In  the  matrix  conjugate  gradient  equations.  If  a  vertex  Is 
shared  by  more  than  one  surface  cell,  the  adjoining  cell  potentials 
are  averaged  by  FORFIL  (4.21)  and  assigned  temporarily  to  the  vertex. 
Once  the  vertlce  potentials  have  been  collected,  the  residuals  (4.30) 
are  calculated  by  either  PCUBES  or  ECUBES  (4.20,  Appendix  B)  and 
shared  back  to  surface  cells  SRFR  entry. 
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5.23  ELEMENT  TABLE,  LTBL 

The  element  table,  LTBL,  Is  i  list  with  one  entry  for  every 
element  In  the  grid.  An  element's  LTBL  entry  can  be  accessed  by 
calculating  Its  relative  address  as  If  It  were  a  3-D  array  LTBL 
(X,Y,Z)  where  the  Z  range  starts  with  the  first  slice  In  core  (5.21) 


Each  word  Is  coded  In  the  fcl lowing  manner: 


I] 


31  |0  9  8|  |7  6  5  4  3  2  1  0  9|  (8  7  6  5  4  31  |2  1  0| 

DC  BA 

where: 

A  -  The  element- type  number. 

B  -  The  number  of  surface  cells  sharing  nodes  with  the  element 
(up  to  15)  (NCELLS) . 

C  -  The  orientation  of  the  cell.  This  Is  only  significant  for 
partially  filled  cells  and  is  explained  in  Reference  5-1. 

0  -  Top/Bottom  flag  for  elements  above  or  below  a  thin  plate. 

D  m  1  -  bottom 
■  2  -  top 

-  3  -  both  top  and  bottom,  type  5 
The  following  element  types  are  flowed: 


Tvoe  Number 


Description 


0 

000 

Empty  cube 

1 

001 

Half-empty  wedge 

2 

010 

Cube  with  diagonal  on  one  face 

3 

011 

Tetrahedron 

4 

100 

Truncated  cube 

5 

101 

Empty  cell  bisected  by  a 
diagonal  thin  plate 

6 

110 

Unused 

7 

111 

Filled  cube 

These  volume  elements 

are  described 

in  4.21. 

5.24.1 


SURFACE  CELL  LIST,  KSURF 


One  of  the  lists  produced  by  VEHICL  and  stored  on  file  11  (see 
Chapter  5.30  on  file  11)  Is  the  surface  cell  list,  KSURF.  This  list 
consists  of  bit  packed  word  pairs  for  each  surface  cell.  The 
information  content  is  explained  below,  and  the  bit  coding  convention 
is  Illustrated  in  Figure  5.24/1.  The  bit  ordering  notation  used  here 
assigns  each  bit  the  exponent  of  2  required  to  move  an  Integer  1  to 
that  location  by  multiplication. 


COND 

NORM 


XI.YI.ZI 

X0,Y0,Z0 

XI.YI.ZI 

MAT 

B 


H 


X0.Y0.Z0 


TB 


Conductor  number,  1  to  15. 

Surface  normal  in  Miller  indices,  two  bits  for  each 
index.  The  lowest  bit  representing  1  or  0,  and  the 
highest  set  for  minus,  off  for  plus. 

Lowest  coordinates  of  the  volume  element  with  which 
the  surface  cell  is  associated  (the  element  that 
the  cell  normal  points  in  to). 

Material  number,  assigned  by  order  of  definition. 

Set  for  all  right-triangular  surface  cells 
(100,0-10,  etc.)  and  for  all  equilateral  (111) 
triangles  whose  enclosing  volume  element  is  mostly 
empty. 

Orientation  code  for  right- triangle  surface  cells. 
The  two  bits  define  the  location  of  the 
right-angled  corner  in  the  plane  of  the  triangle, 
i,  j.  The  greatest  bit  refers  to  j.  The  j  and  i 
are  related  to  the  normal  direction  as  follows: 


NORM 

i 

(0  0  +1)  -  Z 

X 

Y 

X 

Y 

Z 

Y 

Z 

X 

Volume  element  that 

the  surface  normal 

points 

of. 


1  -  bottom  surface  of  a  thin  plate 

2  -  top 
0  -  N/A 


*  .  -l 


The  KSURF  list  is  written  on  file  11  by  either  subroutine 
V. RESURF  or  0. RESURF.  Prior  to  output  it  is  ' Z 1  ordered  to  produce 
sliceability  in  the  chosen  orientation,  it  is  written  on  11  in  a 
series  of  records  with  each  record  contai  ling  a  1  the  word  pairs  with 
a  given  ZI  coordinate.  These  records  are  indexed  by  the  NWSURF(2) 
list  In  record  1  of  file  11.  For  each  ZI  of  the  object  grid  there  is 
a  NWSURF  entry  set  equal  to  the  number  of  KSURF  words  in  the  record 
for  that  ZI.  If  an  NWSURF  entry  is  zero,  ther  corresponding  null  2C 
record  of  KSURF  is  skipped. 


5.25  LCEL,  CONNECTIVITY 


The  LCEL  list  is  used  in  the  potential  solving  segment  to 
connect  node  point  to  surface  cells  (4.20,  5.22).  This  is  a  bit 
packed  list  with  the  following  structure: 

ELT# 

CODED  WORD 
CPDED  WORD 


ELT# 

The  ELT#  is  a  coded  element  identifier, 

ELT#  -  4096  x  (I  +  64  *  J  +  4096  *  K) 
which  serves  as  a  check  for  correct  addressing  in  the  list. 

Addressing  is  accomplished  by  accumulating  the  NCELLS  word  count  from 
the  element  table  LTBL  (5.22,  5.23). 

The  coded  words  are  bit  packed  as  follows: 


Bits  0-7  are  set  if  the  corresponding  vertex  is  shared 
with  the  surface  cell.  The  vertices  are  numbered  with  X 
changing  faster  than  Y  which  changes  faster  than  Z,  e.g., 
for  element  1,  1,  1 

Coordinates 


Number 

1 

2 

3 

4 

5 

6 

7 

8 


X  Y  Z 
1  1  1 
2  1  1 
1  2  1 
2  2  1 
1  1  2 
2  1  2 
1  2  2 
2  2  2 


Is  the  standard  orientation  surface  node  number  (see  4.21) 
that  th<?  surface  will  nave  when  forming  the  element  into 
which  this  surface  points. 

Is  the  surface  number. 


Is  a  code  for  surfaces  that  are  on  the  top  or  bottom  of  a 
thin  plate  (4.21.1). 


5.30  FILE  SYSTEM 


One  of  the  most  outstanding  features  of  POLAR  Is  its  file 
management  system.  This  system,  combined  with  the  sliced  grid  system 
(5.20)  allows  POLAR  to  model  variably  large  3-D  problems  (20,000  grid 
points  is  common),  with  fewer  than  100,000  words  of  core.  The  modules 
VEHICL,  ORIENT,  NTERAK,  and  SHONTL  communicate  through  the  mass 
storage  files  11  and  19  (see  5.31).  Internal  tc  each  module,  other 
files  of  differing  types  are  used  as  scratch  files.  VEHICL  uses  the 
NASCAP  object  definition  coding  and  thus  a  variety  of  NASCAP  files  are 
used  initially  in  VEHICL  as  scratch  files.  This  document  will 
ultimately  describe  these  files,  but  the  reader  is  presently  referred 
to  Reference  1.  Two  files  (11  and  19)  are  used  nstead  of  just  one,  so 
that  one  may  be  indexed  with  literal  name  keys  (19),  and  the  other 
(11),  with  number  type  index  keys. 


5.31  MASS  STORAGE  FILE  MANAGEMENT 


Data  stored  on  the  permanent  file  11  and  19,  and  the  scratch 
file  9  and  10,  is  written  and  retrieved  using  the  CDC  MSIO  system 
(mass-storage-input-output).  On  non-CDC  machines,  the  MSIO  routines 
OPENMS,  WRITMS,  READMS,  and  CLOSMS  are  provided  by  POLAR  FORTRAN 
routines  which  mimic  the  CDC  versions  to  provide  a  machine  independent 
interface  to  the  host  system.  We  now  describe  these  four  routines  as 
they  are  used  in  POLAR. 

OPENMS: 

Example:  DIMENSION  IND  (NUM) 

CALL  OPENMS  (LUN,  IND,  NUM,  t) 

LUN  -  The  logical  unit  number  of  the  file. 

IND  -  Space  provided  for  a  wcrking  copy  of  the  file  index. 

NUM  -  Length  (words)  of  IND 

t  -  type  of  index 

*  0,  number  type  index 
=»  1,  name  type  index 

To  index  XR  records,  a  t  *  0  file  requires  NUM  >  XR  +  1; 
for  t  -  1,  NUM  >  2*XR  +  1. 

READMS: 

Example:  DIMENSION  BUFR(IOOO) 

CALL  READMS  (LUN,  BUFR(IOO) ,NWDS,KEY) 

LUN  -  Logical  unit  number 

BUFR(IOO)  -  Starting  address  to  which  data  is  to  be  read 
NWDS  -  Number  of  words  to  be  read 

KEY  -  The  index  key  under  which  the  data  record  was  stored. 


WRITMS: 

Example:  CALL  WRITMS  (LUN.BUFR.NWDS.KE'  ,r) 

LUN,  NWDS,  and  KEY  are  as  for  READMS;  data  is  read  from 
BUFR.  r  -  -1,  always  for  POL.vR.  This  specifies  that  a 
record  may  be  overwritten  onl/  if  the  new  record  length 
does  not  exceed  the  old  length.  When  this  occurs,  a  new 
record  is  written  and  a  link  .tored  in  the  old  location. 


CLOSMS: 

Example:  CALL  CLOSMS  (LUN) 

This  routine  writes  the  workijg  index  from  core  to  the 
file  copy.  It  is  called  freqiently  to  maintain  an  up  to 
date  file  copy  of  the  index  t)  protect  data  against 
unexpected  crashes  and  stops. 


5.32  MRBUF  PLUS  BUFSET  PLUS  FRIENDS 

To  enhance  the  efficiency  of  both  the  execution  and  development 
of  POLAR,  a  formalized  system  of  variable  characterization  and 
identification  is  used.  This  begins  with  the  array  VPR0PS(20,70) 
wherein  20  different  properties  of  70  different  variables  are 
initialized  by  MRBUF.  To  set  up  a  work  space  for  a  variable  (or  a 
slice  of  a  variable)  in  the  general  purpose  buffer  CBUF,  a  call  is 
made  to  BUFSET  using  the  literal  name  of  a  variable  (5.33).  BUFSET 
will  move  the  vector  properties  from  VPROPS  to  a  working  array 
( 1AVECS( 20. I ) )  and  the  index  I  will  be  written  into  the  MELAD  common 
block  in  the  variable  pseudonym.  For  example 
CALL  BUFSET(5,  'POT',  ...) 

would  result  in  space  for  five  Z  slices  of  potential  to  be  allocated 
in  CBUF  with  all  essential  information  stored  in  IAVECS  (20.IP0T)  with 
IPOT  being  found  in  the  MELAD  common  block. 

The  IAVECS  properties  are  listed  below,  with  a  V  indicating  a 
non-variable  property  that  is  placed  in  VPROPS  by  MRBUF. 

V  IAVECS(l.I)  -  Name 

IAVECS(2, I )  .  Start  address  in  CBUF 

IAVECS(3,I)  »  Number  of  slices 

IAVECS(4, I )  =  Vector  length  of  a  slice 

IAVECS (5,1)  *  Words  per  vector 

(The  number  of  words  in  a  slice  is  IAVECS(4,I)  *  IAVECS(5, I ) . ) 
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V  I AVECS ( 6,1)  - 

IAVECS(7,I)  . 

IAVECS(8, I )  - 

IAVECS(9,I)  - 

IAVECS(IO.I)  - 
IAVECS(11,I)  « 

V  I AVECS( 12 . I )  - 

V  IAVECS ( 13 , I )  - 


V  IAVECS(14,I)  « 


V  I AVECS( 15,1)  - 


Mass  storage  file  number 

Low  pointer  (shifted  slice  coordinates),  see 

property  14  and  Section  5.21 

and 

High  pointer  used  by  the  data  paging  routine 
PAGER 

Lower  (object  coordinates,  5.21) 
and 

Upper  object  limits,  inclusive 

Starting  key  number  for  the  number  key  files. 

X  dimension  of  a  slice 

Type  of  slice  or  vector.  Choices  are: 

*  VAR I  *  -  variable  length  (example,  LCEL) 

' SNGL '  -  single  slice  (example,  SRFV) 

'WORK*  -  work  space 
'OTHR'  -  other  (FOTO) 

1  -  object  slice  (LTBLO 

2  -  real  grid  (POT) 

3  -  outer  virtual  node  (LCOF) 

4  -  virtual  element  grid  (DION) 

Shift  added  to  slice  coordinates  to  prevent 
FORTRAN  MOD  function  of  negative  or  zero 
slice  coordinates 

Y  dimension  of  slice 


L-  L’-  iV?*1.1-  \miT- 


n' .  ■  "*•* 


.*» 
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V  IAVECS(16,I)  =  Lower  Z  limit  of  the  variable  range 


IAVECS(17,I)  =  Pointer  to  relate  node  data  to  auxilliary 

node  data  (necessary  for  double  points 
created  by  thin  plates) 


V  I AVECS ( 18 , I )  «  Word  type,  'REAL',  'INIT'  (integer),  'OCTL', 

'ALPH' 


L„.' 
W  -4', 


.v‘] 


% 

’•■‘•I 


5.33  MRBUF  VARIABLE  LIST 


NAME 

DESCRIPTION  (See  Section) 

LTBL 

Element  table 

KSURF 

Surface  cell  list 

SRFR 

Surface  residual  list 

SRFV 

Surface  voltage  list 

LCEL 

Surface  to  node  connectivity  list 

POT 

Node  potentials 

GI 

Neutral  ion  densities 

SCRN 

Linearlized  screening  term 

MU 

Product  of  matrix  M  dot  U 

R 

Node  residuals 

DD 

Unused 

U 

Congugate  gradient  error  vector 

RHOI 

Sheath  ion  densities 

QE 

Average  element  electric  field 

LTYP 

Element  location  with  respect  to  sheath. 
Also  a  calculation  saver  used  by  CURREN. 

LCOF 

Table  to  provide  direct  addressing  to  the 
LCEL  list  by  element  address 

SRFV 

Surface  V  list 

SRFY 

Surface  Y  list 

VMAP 

Velocity  space  map,  work  space 

RHS 

Right  hand  side  of  charging  equation 

JTOT 

Total  surface  current  list  for  insulators 

and  conductor  list 

JSM 

Small  surface  currents  for  insulators  and 

conductor  list 

VMC 

Voltage  vector  used  to  construct  RHS 
(voltage  minus  conductor) 

I F IX 

List  indicating  surfaces  with  fixed  voltage 
in  Insulator  plus  conduct  list  form 

RMAT 

The  capacitance  matrix  portion  of  charging 
equation 

NLST 

LIST 

MRKR 

AMAT 

VDT 

SCRT 

CLRG 

CSML 

OPRM 

SGMA 

TSRV 

SREL 

SR  FC 

SRFI 

TKSR 

SRIA 

ASRF 

JFIX 

VXB 

SRDT 

EXTV 

JTSR 

JSMS 

PAC 

MAT 


A  list  of  insulating  surfaces 

(Defines  element  location  ICCG  packed  sparse 

matrix 

Marks  the  starts  of  new  rows  in  LIST 
A  work  space  used  for  calculating  RMAT 
Change  n  voltage  portion  of  charging 
equations  (the  answer  found  by  ICCG) 

Scratch  vectors 

Vector  list  of  large  capacitances  of 

insulating  surfaces 

Vector  list  of  small  capacitances  to 

insulating  surfaces  and  conductors 

List  per  surface  of  derivative  of  total 

current  by  surface  voltage 

Conductivity  matrix  including  grid  size 

Trial  surface  voltage  list 

List  of  pointers  per  surface  into  the  LCEL 

list 

Weighted  sums  of  particles  which  impacted  on 

object  during  CURREN 

List  of  surface  ion  currents 

Sets  CBUF  space  to  hold  all  KSURFs  at  once 

Estimate  of  ambient  ion  surface  current 

All  of  KSURF  in  CBUF,  unsliced 

Similar  to  IFIX  only  for  each  surface  cell 

V  cross  B  voltage  bias  for  each  insulating 

surface 

Keeps  the  voltage  of  fixed  surfaces 
Surface  voltages  found  during  first  trial 
step 

Total  current  to  each  surface 

Total  of  "small"  currents  to  each  surface 

Work  space 

Material  type  of  each  surface 


Si 


Conductor  number  of  each  surface 

Area  of  each  surface 

Voltage  from  previous  charge  step 

Composite  ion  density  array 

Memory  of  past  charge  information  (not 

implemented  yet) 

Code  history  in'ormation,  summary 

information  from  previous  PWASON,  CURREN  and 

CHARGE  cycles  (not  implemented  yet) 

Stabilized  charge  density  array 

Auxiliary  GI  values 

Auxiliary  DION  values 

Auxiliary  SCRN  values 

Auxiliary  QUSD  /a lues 

Auxiliary  RHOI  values 

Coordinate  list  for  auliliary  values 

Pre  sigma  (conductance)  calculated  by  VEHICL 

and  ORIENT.  Does  not  include  grid  size. 

Previous  CHARGE  cycle  total  surface  currents 

from  first  trial  step 

Surface  voltages  used  to  find  OLJT 


5.60  ION  DENSITIES 


The  calculation  of  Ion  charge  densities  is  performed  in  two 
major  segments.  Before  any  electric  field  information  is  available 
the  straight  line  thermal  ion  density  is  calculated  everywhere  in  the 
grid.  When  potentials  have  been  calculated,  the  sheath  edge  is  found 
and  particles  are  tracked  from  the  sheath  edge  to  the  object.  The 
algorithms  for  these  two  calculations  are  described  in  the  following 
sections. 

5.61  PRESHEATH  IONS 

The  presheath  ion  density  calculation  consists  of  determining 
the  function  g(x,fi)  and  described  in  Section  3.2.  This  function  has 
value  unity  when  particles  can  reach  point  x  from  angle  0  without 
hitting  the  vehicle,  and  it  has  value  zero  when  the  particles  are 
prevented  from  reaching  x  because  they  are  blocked  by  the  object.  The 
major  routine  in  this  section  of  the  code  is  GEMFAC  for  geometrical 
factor,  and  the  results  used  by  NTERAK  are  GI's  for  geometrical  ions. 
The  GI's  are  element  centered  and  defined  as 


GI(I,0,K)  «  — -  /g(x,0)  /1o(r,v)v2  dv 


For  calculation  of  these  geometrical  factors  we  work  in  a  polar 
coordinate  system  whose  e  *  0,  i  «  0  ray  points  into  the  oncoming 
ions.  In  this  system,  the  function  f1o  is  azimuthal ly  symmetric  and 
the  integral  is  reduced  to 


GI(I»J,K) 


f(ei)  9(V*i)A*i)  Aei 


where  the  function  f(e)  is  normalized  so  that 
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Y  Y  f(«i)  *  1 


This  function  is  calculated  in  FC/L.  Th<  calculations  are  done  on  a 
uniform  grid  with  a  default  resolition  ol  1*  in  e  and  10°  in  i.  The 
greater  resolution  in  the  polar  angle  e  s  necessary  since  f  changes 
so  rapidly  as  we  move  away  from  the  ram  direction.  The  geometrical 
factor  is  calculated  by  taking  the  build  ng  block  surfaces  (A2's  from 
HIDCEL)  and  projecting  them  onto  the  e,  i  plane.  Regions  inside  of 
each  surface  are  then  marked  as  excluded.  The  major  source  of  error 
is  the  interpolation  between  vertices  in  e,  t  space,  since  the 
straight  line  edges  in  Cartesian  space  ate  not  straight  lines  in  e,  t> 
space.  To  improve  accuracy,  ADVERT  adds  extra  vertices  in  the  middle 
of  edges  for  each  A2  surface.  The  numbet  of  vertices  per  edge  is 
controlled  by  NADD,  and  has  default  valut  of  2.  The  calculations  to 
determine  the  points  inside  the  surfaces  are  usually  done  in  STICK 
(for  STICK  a  one  into  the  GEM  array).  Hrwever,  the  cases  of  the  ram 
or  anti-ram  directions  being  excluded  must  be  treated  separately.  The 
poles  in  the  e,  t  space  are  singular  points  and  are  handled  in  STKUP 
and  STKDN  for  the  e  «  0  and  e  =  ir  poles,  respectively. 

GEMFAC  is  called  for  each  surface  by  NEUDEN  (for  neutral 
approximation  density)  which  also  performs  the  angle  summations.  The 
principle  advantage  of  this  geometrical  technique  is  speed,  the  tens 
of  millions  of  g(e,0)  needed  for  the  densities  at  each  grid  point  can 
be  calculated  in  just  a  few  minutes  of  computer  time.  A  few 
representative  plots  of  ram,  regular  and  anti-ram  polar  angle 
projections  are  shown  in  Figures  5.61/1-5.61/3. 


POLAR  PLOT 
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SHEATH  IONS 


The  space  charge  density  of  ions  internal  to  the  sheath 
boundary,  and  currents  of  ions  t)  the  vehicle  surface  must  be 
determined  by  particle  tracking.  The  concepts  involved  were  discussed 
in  Section  3.30  and  4.42.  This  section  documents  the  coding 
responsible  for  these  calculations,  but  a  brief  overview  is  in  order. 

External  to  the  sheath,  electric  fields  are  weak  enough  to  allow 
for  accurate  estimates  of  the  ion  flux  to  any  portion  of  the  sheath 
surface,  including  ram  effects.  Presuming  a  previous  Poisson 
calculation,  the  sheath  is  currently  defined  to  be  an  equipotential 
near  the  ambient  plasma  temperature  (this  is  an  input  parameter). 

Once  the  sheath  is  located,  it  is  divided  into  subareas.  These 
subareas  subsequently  become  'particles'  which  represent  flux  tubes  of 
constant  current,  rather  than  constant  charge.  This  current,  referred 
to  as  current  weights,  is  the  subarea  times  the  input  flux  density  of 
ions  (Section  4.42)  to  the  subarea.  The  actual  particle  tracking  is 
done  per  slice  (4.11)  with  the  particle  'pusher'  sweeping  the  grid 
alternately  in  the  +Z  (called  rig! t)  and  -Z  (left)  direction. 
Trajectories  evolve  in  the  X  and  Y  coordinate  directions  until  they 
exit  a  slice  whereupon  the  trajectory  information  is  stored.  The 
trajectory  is  picked  up  in  the  next  slice  or  the  return  pass  of  the 
pusher.  Ultimately,  they  leave  the  problem  or  more  commonly,  hit  a 
surface  and  are  moved  to  a  'dead-particle1  list,  and  are  later 
processed  into  surface  currents. 

Throughout  all  of  this  pushing,  the  time  a  particle  spends  in  a 
volume  element  is  multiplied  by  its  current  to  determine  the  space 
charge  contribution  to  the  element. 


5.62.10 


SHEATH  EOGE 


The  routine  STHCAL  finds  the  sheath  boundary,  divides  it  into 
"particles",  and  then  writes  sliced  lists  of  particles  onto  file  10. 
The  boundary  potential  was  calculated  by  a  routine  called  FNDBND. 
Currently,  FNDBND  finds  the  boundary  potential  by  asking  the  user  to 
supply  it.  Later,  this  routine  will  calculate  a  potential. 

Once  the  boundary  potential  is  known,  STHCAL  loops  through  all 
of  the  elements,  calling  SHEATH  t«»  check  each  element  to  see  if  it 
contains  the  sheath  potential.  I  part  of  a  boundary  passes  through  a 
cell,  it  divides  the  boundary  sur  ace  into  triangular  particles.  The 
particles  are  defined  by  their  ar  a  (in  grid  lengths  squared)  and  the 
location  of  their  centroid. 

Sometimes  SHEATH  finds  part  cles  which  cannot  exist.  For 
example,  in  large  objects  some  of  the  nodes  within  the  object  will 
have  potentials  of  zero.  If  the  urface  potential  is  higher  than  the 
sheath  potential,  SHEATH  will  think  it  found  part  of  the  sheath 
boundary  and  define  some  particles.  It  is  also  possible  to  find 
particles  which  would  have  had  to  come  from  a  non-source  region. 

These  particles  are  eliminated  by  backtracking  to  see  if  there  is  a 
surface  or  a  high  potential  region  which  would  have  blocked  the 
particle. 

Once  all  the  particles  in  a  z-slice  (4.11)  are  defined,  they  are 
written  into  file  10  with  their  area,  the  location  of  their  centroid, 
and  their  initial  velocity.  Presently,  the  initial  velocity  is 
defined  to  oe  zero.  Then  the  particle  lists  are  stored  in  a  linked 
list  data  structure  (5.62.11)  in  chunks  of  100  or  fewer  particles. 


5.62.11 


THE  PARTICLE  LIST  STRUCTURE 


The  particle  list  Is  kept  In  a  linked  list  data  structure.  An 
array  in  the  common  block  /LNKCOM/  contains  either  -1  or  the  key  of  a 
particle  list.  The  key  is  key  number  of  the  particle  list  in  file  10 
as  it  is  used  by  the  MSIO  package. 

To  find  the  key  of  the  first  particle  list  of  a  certain  z-slice, 
the  /LNKCOM/  array  LKPART(I)  (LKSCUR(i)  f >r  surface  currents)  is 
indexed  by  the  z-coordinate  of  the  slice  4.11,  4.12).  The  rest  of 
particle  lists  for  a  given  z-coordlnate  a*e  indexed  by  the  first  word 
from  the  preceding  list.  This  is  the  MSI)  key  of  the  next  slice. 

When  a  particle  list  does  not  have  anothe  •  list  following  it,  the  key 
it  holds  is  a  -1.  The  negative  one  is  a  "lag  signalling  the  end  of  a 
linked  list. 

For  example,  if  our  problem  had  a  z-coordinate  which  varied  from 
0  to  6  and  200  particles  In  z-slice  0,  73)  particles  in  slice  3  and 
1300  particles  in  slice  4,  file  10  would  le  similar  to  table 
5.62.11/1.  Since  the  order  in  wlich  the  jartlcles  were  stored  affects 
the  actual  contents  of  the  table,  there  are  a  number  of  possible 
arrangements. 

In  the  table,  230  particle'  of  the  z  *  3  slice  are  in  file  10  at 
key  1  and  500  are  at  key  5.  Sin<e  next  key  is  -1  for  key  5,  we  know 
there  are  no  more  particles  in  tl  is  slice. 

As  particles  are  moved  to  < ther  slices,  space  ipens  up  in  the 
middle  of  the  file  (keys  3,  4  an<  8  in  the  example).  To  conserve 
space  and  to  keep  the  file  packe<  ,  the  emptied  keys  ire  also  linked. 

So  when  a  new  particle  list  need1  to  be  stored  on  file  10,  an  emptied 
key  will  be  used  if  there  are  an;  available.  The  key  of  the  first 
empty  location  is  stored  in  the  ariable  10L0KY. 


TABLE  5.62.11/1 

AN  EXAMPLE  0:  THE  PARTICLE  LIST  DATA  STRUCTURE 


First  Key 

List: 

ioldky 

LKPART( 

i  =  0 

i) 

12  3  4 

5 

6 

key  - 

4 

6 

-1-1  1  2 

-1 

-1 

file  10  contents 

Key  No. 

Next  K<*y 

No.  Particles 

z-slice 

1 

5 

230 

3 

2 

9 

300 

4 

3 

-1 

0 

- 

4 

8 

0 

- 

5 

-1 

500 

3 

6 

-1 

200 

0 

7 

-1 

500 

- 

8 

3 

0 

- 

9 

7 

500 

4 

10 

empty 

empty 

- 

Note:  This  example  assumes  a  maximum  page  size  of  500  particles. 
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To  store  the  surface  currents,  another  array  LKSCUR(i)  is  used 
to  hold  the  key  of  the  first  particle  list  for  each  z-slice.  The 
linked  lists  allow  the  surface  currents  to  use  the  empty  spaces  left 
by  'the  particle  list  used  by  the  sheath  particle*  tracking  section, 
which  helps  keep  the  file  packed. 


//// 
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SHEATH  CURRENT 


The  routine  CURREN  controls  the  process  of  finding  the  sheath 
current  (see  Figure  5.62.20/1).  CURREN  calls  the  initialization  and 
exit  routines  CURPEP  and  CUEXIT,  respectively,  and  it  pushes  the 
particles  alternately  to  the  right  (+Z)  then  left  (-Z)  until  all  of 
the  particles  have  left  the  grid  or  hit  the  object.  The  variable, 
NPRTCL,  is  the  number  of  particles  left  which  have  not  been  pushed 
to  completion. 
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5.62.21  CURPEP  (CURRENT  PREPARER) 

Called  by  CURREN,  CURPEP  initializes  the  particle  counters, 
opens  file  10  and  initializes  it  (5.62.11),  clears  CBUF  with  a  call 
to  the  routine  BUFCLR,  ani  calls  STHCAL  to  find  the  initial  set  of 
particles. 

Once  the  initial  particle  lists  are  calculated,  CURPEP  resets 
CBUF  for  PUSHER  with  calls  to  BUFCLR  and  BUFSET.  Then  the  force 
table  (QE),  the  extended  element  table  (LTYP),  and  the  sheath 
current  table  (RH01)  are  initialized  to  complete  the  routine.  To 
speed  up  the  calculations  in  XITCEL  (5.62.22),  the  force  table  (QE) 
contains  the  acceleration.  The  acceleration  is  equal  to  the 
negative  trilinear  electric  field  divided  by  the  temperature  in 
volts.  The  units  of  the  iccelera:ion  are  grid  units  (see  5.62.12). 


5.62.22 


PUSHER  (PARTICLE  PUSHING) 


This  routine  pushes  all  the  particles  to  the  left  or  to  the 
right.  PUSHER  loops  through  all  of  the  particles  in  each  z-slice, 
pushing  particles  until  they  leave  that  slice.  The  particles  leaving 
in  the  forward  direction  are  pushed  again  in  the  next  slice  and  so  on 
when  a  particle's  path  intersects  an  object  face,  the  particle  is 
transferred  to  the  surface  current  list  (5.62-11)  and  counted  as  a 
dead  particle.  Particles  detected  leaving  the  computational  grid  are 
counted  and  removed  from  the  problem  (although  their  previous 
trajectory  information  remains). 

The  routine  which  PUSHER  calls  to  push  a  particle  through  a  cell 
is  named  PUSH. 


PUSH  decides  which  of  two  pushing  techniques  to  use  to  push  a 
particle  out  of  its  cell.  PUSH  checks  the  element  table  (5.23)  to  see 
if  the  element  is  next  to  the  object  or  in  a  partially  filled  cell 
(both  are  labeled  'NEAR'  in  the  LTYP  table  in  CBUF).  The  routine 
STPPSH  moves  particles  which  are  'NEAR'  the  object.  If  the  particle 
is  not  close  to  the  object,  PUSH  calls  XITCEL  (exit  cell)  to  find  the 
time  the  particle  needs  to  exit  the  cell,  and  MOVER  to  move  the 
particle  to  its  new  location. 


XITCEL  solves  the  following  six  quadratic  equations  for  the 
time,  t..j,  required  for  the  trajectory  to  be  traced  from  an  entry 
coordinate  X  •  to  an  exit  coord i na  :e  X..: 

01  Jl 


ji 


01 


Voi t ji 


7  QE1  ‘2 


Jl 


i  *  X,  Y,  Z 

j  *  +.  - 


where  VQi  is  initial  velocity.  QE (  is  the  acceleration  calculated 
from  the  electric  field  at  the  center  of  the  element.  The  smallest 
positive  real  t^  is  chosen  as  the  time  required  by  the  particle  to 
leave  the  cell.  See  Section  5.62.12  for  a  discussion  of  the  special 
units  used  for  the  particle  pushing. 
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MOVER  used  the  time  found  by  XITCEL  to  find  the  new  particle 
location.  First  it  calculates  the  new  position  and  velocity  using 

Xi  -  X«1  +  V*.t  +  \  QE.t2 

V.  .  V*.  +  QE.t 


Then  it  shifts  the  particle  position  by  one  thousandth  of  the 
velocity,  moving  forward  along  the  exit  axis,  found  by  XITCEL,  and 
backwards  along  the  other  two.  This  is  necessary  because  the 
particle's  cell  number  is  referenced  by  taking  the  integer  portion  of 
the  particle  position.  If  a  particle  stopped  exactly  on  the  top  side 
of  element  (i,j,k)  as  it  moved  downward,  the  address  found  by 
truncation  would  be  (i,j,k+l).  To  prevent  this  form  of  faulty 
addressing,  the  particle  is  moved  off  of  the  cell  boundaries. 

Because  the  central  electric  fieid  is  used  for  the  entire 
element,  and  the  total  energy  may  drift  with  each  move,  MOVER 
renormalizes  the  velocity  vector  to  force  the  particle  to  conserve 
energy.  After  MOVER  pushes  the  particle  out  of  the  element,  PUSH 
increments  the  RHOI  (space  current  density)  by  the  time  spent  in  the 
cell  multiplied  by  the  area  of  the  particle. 

When  the  particle  gets  closer  to  the  object,  MOVER  can  no  longer 
be  used  since  the  particle  could  strike  an  object  surface  before  it 
left  the  cell.  To  push  particles  within  a  grid  length  of  the 
spacecraft,  PUSH  calls  STPPSH  (step  push).  STPPSH  checks  to  see  if 
the  particle  is  inside  a  filled  portion  of  an  element.  If  it  is,  the 
routine  finds  which  surface  it  passed  through  and  returns  to  PUSH.  If 
not,  STPPSH  calls  STPPAR  (step  particle)  which  moves  a  particle  for 
time  t.  Time  t  is  the  smaller  of  the  time  required  for  the  particle 
to  free  fall  or  move  at  a  constant  velocity  a  distance  of  one-tenth  of 
a  grid  length. 


smaller  of  1 0/1  VI, 


(  E  /•) 


where  E  is  the  electric  field  at  the  particles  position,  e  is  the 
plasma  temperature  and  D  is  one-tenth  of  a  grid  length.  When  the  time 
step  has  been  computed,  the  particle  is  moved  to  X^,  (i  =  x,y,z) 

1  E  i  2 

X.  «  X  .  +  V  .t  +  Ut^ 
i  oi  oi  c.  e 

vi  *  v^i  +  (Ei/©)t 

After  the  particle  is  moved,  STPPSH  increments  the  RHOI  (space 
current  density)  by  the  current  weight  of  the  particle  times  the  time 
it  was  moved.  Then  checks  to  see  if  the  larticle  left  the  cell  by 
counting  how  many  of  the  element  coordina.es  of  the  new  position 
differ  from  the  old.  If  the  particle  did  not  leave  the  cell,  energy 
conservation  is  checked  and  the  velocity  s  renormalized  if  there  is 
more  than  a  +5  percent  error.  Then  the  particle  is  pushed  again. 

If  the  particle  did  leeve  the  cell,  energy  conservation  and  the 
number  of  element  coordinate;,  which  have  changed  are  checked.  If  the 
number  is  greater  than  one  or  the  energy  is  off,  the  particle  is 
backed  up  until  only  one  element  >oundary  is  crossed  and  the  energy  is 
right.  The  routine  that  doe;  thi .  is  called  MOVBAK  (move  back).  It 
is  important  to  keep  particles  f r  )m  crossing  more  than  one  boundary  at 
a  time,  since  it  is  possible  for  larticles  to  miss  corners  of  objects. 

MOVBAK  backs  up  a  particle  )y  finding  the  average  velocity  of  a 

-►  -f  -f 

particle  during  the  timestep  (vayi  =  (v^  +  v)/2)  then  solving  x  * 
x.  +  v„  t  for  t  on  all  of  the  sides  of  a  cube.  Using  the 
smallest  positive  time  it  finds,  it  moves  the  particle  from  its 
original  point  to  x'. 


x'  ■  x.  +  v  t  . 
v  ave  min 
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MOVBAK  then  moves  the  particle  off  of  the  cell  boundary  by  shifting 
the  position  by  0.001  times  the  velocity  n  the  same  manner  as  MOVER 
did  previously. 

After  calling  MOVBAK,  STPPSf  checks  energy  conservation  again. 
After  renormalizing  the  velocity,  if  necessary,  and  incrementing  RHOI, 
the  particle  is  checked  to  see  if  it  hit  a  surface  as  it  left  the 
element. 
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*.•  v.v, 


V.  .* 

•  "I 


■-.-■■.■'-.I 
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ION  SURFACE  CURRENTS 


The  ion  surface  currents  are  found  in  the  list,  SRFI.  This  list 
is  created  in  the  segment  headed  by  the  subroutine  IONCUR  from  the 
dead  particle  list  (dead-list)  created  by  the  CURREN  segment.  The 
upper  structure  of  this  segment  is  illustrated  in  Figure  5.71/1. 


Figure  5.71.1. 

The  creation  of  the  SRFI  list  occurs  in  two  main  steps;  step  1 
reduces  the  dead-list  to  an  intermediate  SRFC  list,  and  step  2 
redistributes  the  surface  currents  among  the  surfaces.  The 
justification  and  computational  techniques  for  these  steps  have  been 
discussed  in  Section  4.53. 

Step  1  is  controlled  from  IONCUR  and  performed  by  INICUR.  The 
dead-list  can  be  very  large  with  an  order  that  is  best  described  as 
chronological.  A  particular  surface  will  appear  as  often  as  it  is 
struck  by  a  particle.  To  speed  up  the  surface  current  calculation, 
and  to  reduce  the  noise  inherent  to  particle  pushing,  INICUR  reads 
through  the  dead-list  sequentially  and  simultaneously  accumulates  in 
the  SRFC  list  the  "average"  particle  (see  4.53)  for  each  surface. 
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This  average  particle  has  the  sum  of  the  contributing  current  weights 
with  an  average  impact  location,  energy,  and  velocity.  These  averages 
are  weighted  by  the  current  weights  (4.53). 

Step  2  is  the  redistribution  or  sharing  of  the  "raw"  surface 
currents  in  the  SRFC  list.  This  is  done  to  further  reduce  the  "noise" 
in  the  raw  ion  surface  currents  (4.53).  Thus,  IONCUR  will  next  loop 
over  the  surfaces  in  SRFC  and  for  each  surface,  S,  call  SPIATR  to 
calculate  the  bilinear  weights,  SPW  (node),  which  are  used  to 
distribute  the  SRFC  current  to  the  vertices  of  the  surface.  These 
node  currents  are  to  be  shared  back  to  all  of  the  surfaces  adjoining 
each  node.  IONCUR  loops  over  the  surface  vertices  calling  GETWGT  to 
calculate  the  CRW  (node,  ns)  where  ns  Indexes  neighboring  surfaces 
(4.53).  The  surface-node-surface  connectivity  is  provided  by  the  LCEL 
list  (5.25).  Since  the  LCEL  list  is  designed  to  be  read  sequentially 
and  is  ordered  by  slice  and  element,  direct  access  to  the  needed 
section  of  LCEL  is  provided  by  an  index  list,  SREL  (5.25). 

After  the  CRW  have  been  obtained  for  a  node,  SPREAD  is  called  to 
perform  the  summation; 

SRFI  (ns)  -  SRFI  (ns) 

+  UNITS  *  CRW  (node,  ns)  *  SPW  (NODE)  *  SRFC  (S) 

where  ns  ranges  over  the  neighboring  surfaces  including  surface  S. 

UNITS  -  ECHRG  *  DXMESH2  *  FNORMI,  where  ECHRG  -  1.6  x  10-19  Coulombs 
and  DXMESH  is  the  length  of  a  mesh  unit  in  meters.  FNORMI  is  the 
unperturbed  Maxwellian  flux  density  against  which  the  current  weights  are 
calibrated; 


where,  in  MKS,  n^  is  the  ion  density,  k  is  Boltzmann's  constant,  T 
is  temperature  and  m^  is  the  ion  mass. 
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5.73  CHARGE  (SURFACE  CHARGING  CONTROL) 

CHARGE  is  the-  entry  level  routine  into  the  surface  charging 
section  of  POLAR  (see  Figure  5.73/1).  It  initializes  the  charge  cycle 
by  reading  in  the  material  properties  and  calculating  the  plasma  to 
surface  (routine  MAKCSM)  and  surface  to  conductor  (MAKCLG) 
capacitances. 


Figure  5.73/1.  Structure  diagram  of  subroutine  CHARGE. 

After  the  initialization  routines  have  been  called,  CHARGE 
calculates  the  explicit  then  implicit  surface  potentials.  Presently, 
CHARGE  loops  on  the  SURCHG  sequence  by  the  fixed  input  number,  MAXITT; 
however,  a  convergence  test  will  be  placed  in  the  location  indicated 
by  the  empty  oval.  Upon  conclusion,  the  array  SURFV  contains  the  new 
surface  potential  which  is  stored  on  file  19. 

The  computational  theory  for  the  charging  section  is  discussed 
in  Section  4.50. 


5.73.1  SURCHG  (SURFACE  CHARGER) 

SURCHG  calls  the  routines  needed  to  set  up  the  equation  to  be 
solved  and  finds  the  next  set  of  surface  voltages.  SURCHG  can  solve 
the  charging  equation  In  either  the  explicit  form  (Eq.  (5.73-1-1))  or 
the  Implicit  form  (Eq.  (5.73.1-2)). 


(5.73.1-1) 


Using  a  flag  sent  by  CHARGE,  SURCHG  chooses  which  form  of  the  charging 
equation  to  solve  (see  Figure  5.73.1/1).  When  solving  the  Implicit 
charging  equation  (5.73.1-2),  the  SURCHG  assumes  an  explicit  solution 
had  been  found  previously. 


Figure  5.73.1/1.  Structure  diagram  of  the  routine,  SURCHG. 
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SURCH6,  called  with  an  "explicit"  flag,  generates  o(MAKSGM), 
V(t)  (MAKV),  and  Ijt)  -  a  V(t)(MAKRHS) ,  then  calculates  V(t+at) 
explicitly.  When  an  implicit  flacj  is  received,  MAKDJ  is  called  to 
calculate  dl/dV.  MAKDJ  will  call  MAKJ  which  will  recall  the  current 
routine  (4.50,  5.70)  for  an  estim.  te  of  I(t+At)  using  the  explicit 
V(t+At). 

At  this  point,  both  chargim  equations  can  be  treated  the  same 
way.  The  matrix. 


it  +  !  -  "HV  • 

is  calculated  by  MATGEN  (using  dl/dV  «  0  for  the  explicit  case), 
setting  up  M  for  the  ICCG  call  by  SURVLT.  SURVLT  solves  Eq.  (5.73.1-3) 

M  AV  -  R  (5.73.1-3) 

where  R  is  the  vector  found  by  MAKRHS  and  aV  is  the  change  in  the 
surface  potential. 

Using  the  aV  found  by  SURVLT,  SURSET  calculates  the  new  surface 
potentials  and  saves  them,  completing  the  charging  timestep.  The 
following  sections  discuss  the  above  routines  in  more  detail. 
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5.73.2 


CHARGING  MATRIX  AND  VECTOR  FORMULATION 


As  discussed  In  Section  4.51,  there  are  two  cases  which  affect 
the  charging  equations,  5.73.1-1  and  5.73.1-2,  depending  on  the 
occurrence  or  non-occurrence  of  fixed  potential  surfaces.  When  a 
surface  potential  Is  fixed,  the  matrices  and  vectors  of  5.73.1-2  are 
constructed  exactly  as  Implied.  If  a  surface  has  been  fixed  by  CBRAIN 
(called  from  SURCHG)  SURCHG  passes  a  flag,  IFIXED,  to  the  matrix  and 
vector  routines  (MATGEN,  MAKRHS,  MAKJ,  MAKDP,  MAKV)  to  construct  the 
more  diagonalized  matrices,  C  and  a,  and  the  corresponding  vectors  V 
and  I.  These  transformations  are  discussed  In  4.51,  but  they  are 
characterized  by  constructing  V(t)  from  the  potential  difference 
between  a  surface  and  the  underlying  conductor  Instead  of  simply  the 
surface  potential.  The  effect  of  this  is  to  reduce  the  off-diagonal 
elements  and  Increase  the  diagonal  elements  of  the  amalgamated  matrix 
M  (Eq.  (5.73.1-3)).  ICCG  likes  tiis  and  will  generally  converge 
faster. 

Since  there  can  be  as  many  as  1200  surfaces  or  so,  it  was 
necessary  to  pack  all  the  matrices  In  the  problem  (unpacked  it  could 
be  1  million  words/matrix).  Sine*  the  matrices  are  mostly  empty,  just 
saving  the  nonzero  entries  and  th*1r  locations  simplifies  the  problem 
greatly.  The  entry  locations  are  stored  in  a  list  (called  'LIST'  in 
MRBUF )  with  a  second  list  ('MRKR'J  being  used  to  indicate  the  location 
of  rows  in  LIST.  The  entry  locations  are  stored  row  by  row  with  the 
first  entry  for  a  row  being  the  negative  row  nunber.  For  example,  the 
nonzero  locations  in  the  following  matrix 
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would  appear  in  LIST  as  -1,  -2,  3,  -3,  2,  4,  5,  -4,  2,  3,  5,  -5,  3,  4 
and  MRKR  would  be  1,  2,  4,  8,  12,  10000  with  the  10000  signalling  the 
end.  Since  the  matrices  always  have  nonzero  diagonals,  the  -2  in  LIST 
means  there  Is  an  entry  at  (2,  2).  The  3  following  it  means  (2,3)  and 
so  on.  For  large  problems  this  greatly  reduces  the  data 
requirements. 


MAKSGM  (MAKE  THE  o  MATRIX) 


MAKSGM  makes  the  o  natrix  by  taking  conductivity  information 
created  by  VEHICL  and  moving  it  to  the  right  place  in  the  appropriate 
matrix  form  (see  5.72.2)  for  ICCG. 

MAKV  (MAKE  THE  VOLTAGE  VECTOR) 

MAKV  builds  the  voltage  vector  in  the  appropriate  form  (5.72.2) 
using  a  surface  voltage  list  and  the  conductor  voltage  common  block. 
The  LAD  number  of  the  desired  surface  voltage  list  is  passed  as  an 
argument  to  this  routine. 

MAKRHS  (MAKE  THE  RIGHT  HAND  SIDE) 

MAKRHS  makes  the  right  hand  side  of  :he  vector  equation  solved 
by  ICCG.  The  right  hand  side  is  equal  to 

RHS  *  L  -  9  V  . 

_*• - 

This  is  done  by  first  calling  MAKJ  to  calculate  the  current  vector. 
Then  MAKRHS  finds  the  product  of  aV  and  subtracts  it  from  the 
current.  The  right  hand  side  of  the  vectcr  equation  is  the  same  for 
both  the  explicit  and  implicit  formulatiors  so  it  only  needs  to  be 
called  once  for  the  explicit  step.  Then  the  implicit  step  will  just 
use  the  RHS  found  during  the  explicit  calculation. 


MAKJ  (MAKE  THE  CURRENT  VECTORS) 


This  routine  finds  the  current  vector  I,  in  the  appropriate  form 
(see  5.72.2),  given  a  list  of  surfaces  voltages.  To  find  the 
contributions  to  the  current  from  the  various  sources,  MAKJ  calls  the 
routines  which  calculate  the  incident,  secondary,  and  backscattered 
electron  fluxes  and  the  incident  and  secondary  ion  currents. 

Two  lists  are  created  by  MAKJ,  one  is  the  total  current,  I.  The 
other  is  the  sum  of  the  secondary  currents,  I$m.  The  secondaries 
will  be  used  in  the  future  to  locate  surfaces  which  will  need  to  be 
fixed. 

MAKOJ  (MAKE  THE  dl/dV  MATRIX) 

MAKOJ  is  called  before  the  solution  of  the  implicit  equation  to 
create  the  dl/dV  matrix.  To  find  dl/dV,  MAKOJ  uses 


The  surface  voltages  at  t+at  were  found  during  the  explicit  step.  The 
surface  currents  at  t+at  are  found  by  calling  MAKJ  and  giving  it  the 
voltages  calculated  by  the  explicit  step. 

To  correct  for  the  explicit  charging  equations  tendency  to 
overcharge,  a  limit  is  placed  on  the  change  in  voltage.  During  the 
keyword  input  phase,  the  variable  'DVLIM'  is  set  and  this  is  the 
voltage  change  limit.  This,  for  a  surface  i,  V^(t+at)  can  be  written 

V.(t+at)  -  V1(t)  +  atV. 


where  |aV1- |  is  the  lesser  of  the  explicity  change  or  DVLIM.  The 
limited  voltage  is  then  used  to  find  the  new  surface  current.  The 
limited  surface  voltages  at  t+At  are  also  sent  to  MAKV  to  put  in  the 
appropriate  form  (see  5.73.2). 

Once  I(t+at)  and  V(t+at)  have  been  calculated,  dl/dV  is 
calculated  for  each  vector  entry.  If  the  value  is  not  negative,  dl/dV 
is  set  equal  to  a  zero  for  that  vector  entry.  This  is  done  to  prevent 
the  destabilizing  effect  of  a  positive  current  derivative  in  an 
element  on  the  matrix  diagonal  (see  3.41).  And  since  surface  to 
surface  interactions  are  not  being  dealt  with  presently,  there  are 
only  diagonal  elements  in  the  diydV  matrix. 

MATGEN  (MATRIX  GENERATION) 

MATGEN  finds  the  sun  of  the  matrices  which  multiply  the  voltage 
vector,  aV,  solved  for  by  ICCG.  It  performs  the  sum 


SURVLT  (SURFACE  VOLTAGE) 

SURVLT  recovers  from  storage  on  file  19,  the  M  matrix  and  RHS 
vector  for  use  by  ICCG.  It  also  calls  ICCG  (4.32)  which  returns  aV. 
Currently,  the  initial  guess  for  aV  is  aV  *  0.  Also,  we  are  presently 
fixing  the  main  conductor,  or  spacecraft  ground.  The  ground  charges 
only  according  to  its  capacitance  to  the  plasma  which  is  small.  All 
other  surfaces  and  conductors  have  larger  capacitance  directly  or 
indirectly  to  the  ground  (see  Appendix  A,  and  Section  4.51).  Thus, 
fixing  the  ground  simplifies  the  checkout  of  the  charging  algorithms. 
This  restriction  will  be  removed  at  the  appropriate  time. 
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SURSET  {SURFACE  VOLTAGE  RESET) 


SURSET  uses  the  solution  found  by  SURVLT  to  find  the  new  surface 
and  conductor  voltages  after  charging. 


• . 


5.82 


GRAPHICAL  CODE  STRUCTURE 


5.82.10  AN  OVERVIEW  OF  SHONTL 

SHONTL  is  a  module  designed  to  create  the  graphics  commands  for 
PLOTRD.  It  presents  crcss-sections  of  data  generated  by  NTERAK  as 
contour  plots.  Currently,  axial  slices  of  the  positive  ion  density, 
the  electric  field  potential,  the  sheath  boundary,  and  the  particle 
trajectories  can  be  plotted. 

The  form  of  the  plots  can  be  varied  by  using  keyword  commands. 
The  plot  types  and  slice  locations  are  also  defined  by  keywords.  The 
keywords  and  their  use  are  described  in  Section  6.5. 

5.82.11  SHONTL 

This  is  the  main  routine  of  the  module.  SHONTL  oversees  the 
order  of  operations  of  the  various  phases  of  the  plotting  process  (see 
Figure  5.82.11/1).  It  calls  an  initialization  routine  (PLINIT),  an 
exit  routine  (PLEXIT)  and  cycles  on  the  input  routine  and  the  plotting 
routine  (PLINPT  and  GENPLT,  respectively).  EOF  is  a  flag  from  PLINPT 
signalling  the  end  of  a  plotting  session. 

5.82.12  PLINIT  (PLOT  INITIALIZATION) 

PLINIT  is  the  initialization  routine.  It  opens  POLAR  data  files 
11  and  19,  sets  the  raster  graphics  window,  initializes  common  blocks, 
sets  the  defaults  for  plot  descriptions  and  prints  a  welcoming  message. 


Figure  5.82.11/1.  A  general  structure  diagram  of  SHONTL 
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5.82.13  PLINPT  (PLOT  INPUT) 

This  routine  is  the  keyword  input  section  of  SHONTL.  PLINPT 
recognizes  the  various  keywords  (described  in  detail  in  Section  6.5) 
and  sets  the  appropriate  flag  for  6ENPLT.  In  add i t i on  to  keywords  for 
plotting  features  and  to  describe  the  data  for  plotting,  keywords  are 
also  recognized  which  direct  the  data  handling,  control  the  SHONTL 
exiting  and  plotting  procedure,  and  provide  useful  aids  for  the  user. 
These  include  a  'HELP'  command  which  provides  a  short  manual  for 
successful  plot  production,  a  ‘ DICT '  command  to  call  a  routine  to 
provide  a  complete  dictionary  of  keywords  and  a  'WHAT'  command  to  see 
which  plotting  features  have  been  selected. 

Additionally,  soon  there  will  be  a  'PROMPT'  command  which  will 
shift  the  input  mode  to  a  prompt  input  mode.  This  will  be  instructive 
the  first  few  times  SHONTL  is  used  since  it  steps  through  the 
available  features  in  sequence,  describing  each  briefly. 

All  of  the  plotting  features  have  default  values  set  in  PLINPT 
so  that  no  harm  will  be  done  if  a  flag  is  not  set  in  PLINPT  (the 
default  values  are  described  in  Section  6  5  also). 

5.82.14  GENPLT  (GENERATE  PLOTS) 

GENPLT  calls  the  routines  responsible  for  generating  the 
pseudo-graphics  calls  used  by  PLOTRO.  The  flags  set  by  PLINIT  and 
PLINPT  are  used  to  decide  which  plotting  routines  to  call. 

To  make  a  plot,  GENPLT  sets  the  constants  it  will  need,  reads 
the  data  to  be  plotted,  generates  the  plot,  along  with  any  extra 
features  selected,  and  then  prepares  for  the  next:  plot. 
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5.82.15  PLEXIT  (PLOT  EXIT) 

PLEXIT  is  the  exit  routine  for  SHONTL.  It  calls  PLOTRD  if  plots 
were  created  and  are  to  be  printed. 
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6.0  OPERATING  INSTRUCTIONS 


In  general,  POLAR  can  be  run  in  either  an  interactive  or  batch 
computing  environment  using  keyword  input.  Commands  controlling  run 
characteristics,  defining  environmental  constants,  and  choosing  the 
amount  of  appropriate  output  are  either  recognized  by  the  module's 
input  routine  or  by  a  general  input  routine  (POLINP)  which  processes 
non-module  specific  keywords  such  as  the  grid  size  and  diagnostic 
keywords. 

The  exception  to  this  general  rule  is  the  set  of  keywords  used 
to  define  an  object.  These  keywords  are  expected  to  be  found  within  a 
definition  file  separate  from  the  VEHICL  runstream.  Section  6.1 
describes  the  intricacies  of  object  definition  in  detail  and  includes 
several  helpful  examples. 

The  other  sections  describe  the  keywords  pertinent  to  all  of  the 
modules  (Section  6.7)  or  keywords  appropriate  to  a  particular  module 
(Sections  6.2  to  6.5).  Some  keywords  appear  in  several  locations  for 
the  sake  of  convenience. 
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6.10  OBJECTS 

POLAR  objects  are  defined  separately  from  the  VEHICL  runstream. 
VEHICL  will  look  for  the  object  definition  file  as  unit  20  (CYBER)  or 
as  PREOBJ.  on  UNIVAC  with  PRE  being  a  prefix  given  in  the  VEHICL 
runstream  (Section  6.2). 

POLAR  objects  are  defined  in  an  object  grid  of  variable 
proportions  subject  to  the  limitation  NX*NY*NZ  *  9537; 

NY, NX  <  32;  NZ  <  33.  The  keyin  language  is  identical  to  NASCAP, 
except  for  the  addition  of  slanted  thin  plates  and  the  omission  of 
booms  (POLAR  does  not  do  booms),  antennas,  and  thin  triangular 
plates.  If  “empty  space'*  and  “object"  both  coexist  in  the  same 
computational  space  what  makes  objects  distinguishable  ?  The  answer  is 
that  POLAR  can  distinguish  between  volume  elements  that  are  filled 
(with  object)  and  those  that  are  empty  (except  for  ambient  plasma  of 
course).  Once  we  have  this  distinction  it  is  easy  to  see  how  objects 
can  be  constructed  by  filling  in  collections  of  volume  elements.  For 
example,  a  simple  cuboid  may  be  constructed  by  filling  in  2  x  3  x  4  «= 
24  elements  as  shown  in  Figure  6/1. 

While  arrangements  of  completely  filled  and  completely  empty 
cubes  can  be  quite  versatile  in  representing  objects  of  many  different 
shapes,  more  sophisticated  representations  are  possible  if  we  allow 
cubes  to  be  partially  filled  (or  partially  empty).  Only  three 
partially  filled  cubes  are  allowed.  These  are  shown  in  Figure  6/2. 

While  it  is  easy  to  see  how  objects  might  be  constructed  by 
filling  or  partially  filling  individual  volume  elements,  a  command 
structure  that  required  the  user  to  specify  every  element  comprising 
an  object  would  be  very  cumbersome  to  use.  So  several  generalized 
objects  are  definable. 

It  is  very  Important  to  note  that  POLAR  objects  must  never  touch 
the  edge  of  the  object  grid  defined  by  VEHICL  (see  Section  6.2). 
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6.10.10  BUILDING  BLOCKS 

To  greatly  simplify  the  user  definition  of  objects,  POLAR 
pre-deflnes  common 1y  used  shapes  built  up  from  Individual  elements. 
These  shapes  are  called  POLAR  BUILDING  BLOCKS.  There  are  eight. 

Flat  Plate 
Slanted  Plate 
Cuboid 
Octagon 
Quasi  sphere 
Tetrahedron 
Wedge 
FIL111 

These  are  shown  In  Figure  6/3.  These  basic  shapes  can  be  defined  to 
be  any  size  (within  the  Inner  grid).  POLAR  automatically  Includes  the 
correct  number  of  Individual  elements  for  the  size  of  building  block 
chosen  by  the  user. 

6.10.11  COMMANDS  (OR  HOW  DO  I  ACTUALLY  DEFINE  AN  OBJECT?) 

The  POLAR  module  VEHICL  Is  responsible  for  recognizing  and 
understanding  the  object  defined  by  the  user  In  the  object  definition 
file. 

Each  building  block  has  its  own  keyword.  For  example,  the 
quasi-sphere  Is  associated  with  the  word  QSPHERE,  and  the  cuboid 
(rectangular  parallelepiped)  with  the  word  RECTAN.  The  building 
blocks  and  their  keywords  are  summarized  in  Table  6/1. 

Once  VEHICL  has  read  a  building  block  keyword  from  the  object 
definition  file.  It  then  expects  to  find  several  more  lines  (or  cards) 
setting  the  block  parameters.  These  might  include  the  dimensions  of 


Figure  6/3.  The  eight  building  block  types  are  shown  here.  The 
uppermost  object  shows  a  FIL111  smoothing  a  corner. 
Below,  from  left  to  right  are  quasi-sphere,  octagon 
right  cylinder,  tetrahedron,  wedge,  and  rectangular 
parallelepiped. 


TABLE  6/1.  POLAR  BUILDING  BLOCKS  AND  THEIR  KEYWORDS 


Keyword 

FIL111 

OCTAGON 

PATCHR 

PATCHW 

PLATE 

QSPHERE 

RECTAN 

SLANT 

TETRAH 


Building  Block  Description 
Smooth  inside  of  a  diagonal  corner 
Right  octagonal  cylinder 
Surface  of  a  rectangle 
Diagonal  face  of  a  wedge 
Arbitrarily  thin  plate  or  cuboid 
Quasi  sphere 

Cuboid  or  rectangular  parallelepiped 
Thin  plate  slanted  at  45* 

Tetrahedron 

Wedge  derived  from  half  a  cube 


WEDGE 
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the  building  block,  its  orientation  and  the  materials  that  cover  its 
surface.  (Surface  materials  are  discussed  in  Chapter  6.12.)  Finally, 
VEHICL  expects  to  find  a  line  'ENDOBJ'  telling  it  that  no  more 
information  referring  to  the  present  block  is  coming  and  to  expect  the 
next  building  block  keyword.  The  information  to  be  entered  in  the 
object  definition  file  for  each  building  block  is  summarized  in  Table 
6/2.  Note  that  numbers  and  words  may  be  separated  by  one  or  more 
spaces  on  the  same  line.  (Input  is  free-format. ) 

The  keyword  'ENOSAT'  signals  the  end  of  the  satellite  definition 
and  should  be  included  at  the  end  of  all  vehicle  descriptions. 

6.10.12  PLATES  AND  PATCHES 

A  careful  inspection  of  Table  6/1  will  show  that  there  are  some 
building  blocks  that  are  not  derived  from  cubic  volume  elements. 

These  are  the  PLATE,  SLANT,  PATCHR  and  PATCHW. 

PLATEs  are  arbitrarily  thin  cuboids  (RECTANS).  They  are  assumed 
to  have  only  a  top  and  a  bottom,  the  sides  being  of  negligible 
height.  Flat  plates  always  lie  in  one  of  the  axis  planes  (XY,  XZ, 

YZ).  SLANTed  plates  lie  along  one  axis,  and  at  a  45*  angle  to  the 
other  two. 

PATCHR  and  PATCHW  are  the  surfaces  only  of  a  cuboid  and  wedge, 
respectively.  They  are  used  to  change  the  surface  material  patterns 
of  existing  building  blocks  and  should  never  be  defined  in  spaces  not 
already  occupied  by  solid  objects.  (Objects  defined  to  occupy  the 
same  space  are  explained  in  Section  6.14.) 
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TABLE  6/2.  OBJECT  DEFINITION  -  FILE  20 


OBJECT  DEFINITION 
SYNTAX 

rectan 
CORNER  <  y : 

DELTAS  A*  Ay  At 

(UP  TO  6  SURFACE  CARDS) 

ENOOBJ 


OBJECT  DEFINITION 

EXAMPLES 

rectan 

CORNER  3-38 
DELTAS  1  2  4 
SURFACE  +X  ALUMINUM 
SURFACE  -X  ALUMINUM 
SURFACE  *y  ALUMINUM 
SURFACE  -  V  ALUMINUM 
SURFACE  *z  ALUMINUM 
SURFACE  -Z  ALUMINUM 
ENDOBJ 


OBJECT  DEFINITION  OBJECT  DEFINITION 
SYNTAX  EXAMPLES 


tetrah 
CORNER  x  y  z 
FACE  maienamsme  normal 
Hype  Hi) 

LENGTH  ax 

(UP  TO  3  SURFACE  CARDS) 
ENOOBJ 


WEDGE  WEDGE 

CORNER  x  y  z  CORNER  -  3  2  1 

FACE  matenawame  normal  FACE  SI02  -  i  -  i  0 
(typenO)  LENGTH  i  1  3 

LENGTH  ax  Ay  AZ  SURFACE  ♦  X  SI02 

(UP  TO  4  SURFACE  CAROS)  SURFACE  *  V  SI02 
ENOOBJ  SURFACE  +Z  GOLD 

SURFACE  -Z  SI02 
ENDOBJ 

TETRAH  TETRAH 

CORNER  xyi  CORNER  -3  -2  8 

FACE  malar  lama  me  normal  FACE  KAPTON  11-1 

(lypa  111)  LENGTH  2 

LENGTH  Ax  SURFACE  -X  TEFLON 

(UP  TO  3  SURFACE  CARDS)  SURFACE  -  Y  KAPTON 

ENOOBJ  SURFACE  +Z  TEFLON 

ENOOBJ 

OCTAGON  OCTAGON 

AXIS  xyn'vz'  AXIS  3.  2.  -6  3.  2  -9 

WIDTH  w  WIDTH  3 

SIDES  SIDE  1 

(UP  TO  3  SPECIAL  SURFACE  SURFACE  +  SILVER 
CARDS  "  +  \  "  -  SURFACE  -  SILVER 

or  "C")  SURFACE  C  MAGNES 

ENOOBJ  ENOOBJ 


Fit.  til 

CORNERLINE  x  y  z  x  y'z' 
FACE  maianainama  normal 
(typa  Hi) 

ENDOBJ 

PLATE 

CORNER  x  y  z 
DELTAS  Ax  Ay  AZ 

TOP  x  maianainama 

BOTTOM  *  f  5  )  maianainama 
ENDOBJ  X2/ 

PATCHR 

CORNER  x  y  z 

OELTAS  Ax  Ay  AZ 

(UP  TO  6  SURFACE  CAROS) 

ENDOBJ 

PATCHW 
CORNER  x  y  z 
FACE  maianainama  normal 
(lypa  110) 

LENGTH  Ax  Ay  AZ 

(UP  TO  4  SURFACE  CARDS) 

ENDOBJ 


FlLHi 

CORNER  3.  2  6.  -5  4  6 
FACE  SOLAR  -1.-1  -  1 
ENOOBJ 

PLATE 

CORNER  -  1  - i  -  10 
OELTAS  2  2  0 
TOP  *Z  CPAINT 
BOTTOM  -Z  CPAINT 
ENOOBJ 


PATCHR 

CORNER  3-28 
DELTAS  1  0  1 
SURFACE  -Y  SCREEN 
ENDOBJ 

PATCHW 

CORNER  -327 
FACE  AOUADG  -  1  -  1  0 
LENGTH  1  1  1 
ENDOBJ 


NOTES  "normal  '  « three  values, 
each  either  ♦  i .  o.  or  - 1 

SURFACE  CARO  has  the  following  format 
SURFACE  *  maianainama 


SPECIAL  surface  CARD  « 
SURFACE  (jj)  maianainama 


OSPHERE 
CENTER  x  y  z 
DIAMETER  d 
SIDES 

MATERIAL  maianainama 
•ENOOBJ 

SLANT 

CORNER  X  y  z 
TOP  materialnormal 
(typa  U0) 
BOTTOM  aatarial 
LENGTH  4X  Ay  A* 
ENDOBJ 


OSPHERE 
CENTER  0  0.  0 
DIAMETER  4 
SIDE  2 

MATERIAL  NPAINT 
ENDOBJ 

SLANT 

CORNER  -1-10 
TOP  TEFLON  110 

BOTTOM  KAPTON 
LENGTH  223 
ENDOBJ 


OTHER  OBJECT  DEFINITION  COMMANDS 


ENDSAT 
COMMENT 
OFFSET  i  |  k 
CONDUCTOR  n 

DELETE  1 1  k 
unrecognized  word 


Must  oe  last  card  m  hie 
No  effect. 

Moves  coordinate  origin 

Sets  numoer  of  underlying  conductor 

(js."<15>. 

Deletes  surfaces,  leaving  empty  can 
Assumed  to  be  name  of  new  surface 
material  Next  card  scanned  for 
parameters 


ss 


6.10.13  SPECIAL  SHAPES 


FIL111  is  a  special  shape  designed  to  f i'll  in  "steps"  whose 
corner  line  runs  at  45*  to  the  grid  lines  in  any  axis  plane  (i.e.,  XY, 
ZY,  XZ)  (Figure  6/4a).  There  are  two  kind  of  "steps"  that  can  occur 
between  POLAR  building  blocks.  For  example,  a  small  cuboid  on  top  of 
another  creates  four  "steps"  that  lie  along  grid  lines  (Figure  6/4b). 
These  may  be  "filled  in"  or  smoothed  by  defining  a  WEDGE  to  lie  along 
the  corner  line  of  the  step.  A  second  type  of  step  is  possible 
however  when,  for  example,  a  tetrahedron  or  octagon  is  defined  to  sit 
on  top  of  another  building  block.  These  steps  have  corner  lines  that 
run  at  45*  between  grid  lines.  This  is  shown  in  Figure  6 /4c.  Such 
steps  can  be  smoothed  or  filled  in  by  a  combination  of  tetrahedra  and 
truncated  cubes.  This  combination  is  supplied  as  the  building  block 
FIL111. 

6.10.14  BUILDING  BLOCK  PARAMETERS  (OR  WHO'S  ON  NEXT?) 

The  very  center  of  the  object  grid  is  assumed  to  be  the  origin 
of  the  coordinate  system  0,  0,  0.  Hence  the  grid  itself  extends  from 
-8  to  +8  in  the  X  and  Y  directions  and  from  -16  to  +16  in  the  Z 
direction.  This  coordinate  system  is  used  to  specify  the  position  and 
size  of  the  building  blocks  in  the  parameter  "cards"  or  lines 
following  the  building  block  keyword.  Let  us  examine  the  definition 
of  each  building  block  in  detail  to  see  how  this  works. 


6.10.15  RECTAN 


The  following  cards  define  a  cuboid  or  rectangular 
parallelepiped: 

RECTAN 

CORNER  x  y  z 
DELTAS  ax.  Ay,  az 
SURFACE  +X  GOLD 
SURFACE  -Y  KAPTON 

(Four  more  SURFACE  cards  for  -X,  +Y,  +Z,  -Z) 
ENDOBJ 


Notes: 

1.  RECTAN:  is  the  building  block  keyword. 

2.  CORNER  x  y  z:  defines  the  coordinate  of  the  lowest  indexed 
corner  of  the  cuboid  (the  one  so  that  if  you  added  up  x  +  y  +  z 
it  would  give  the  lowest  (least  positive)  number). 

3.  DELTAS  ax.  Ay,  az:  gives  the  length  of  sides  of  the  cuboid 
along  the  X,  Y  and  Z  axes.  (Note  that  the  edges  of  the  cuboid 
must  lie  in  the  direction  of  the  three  axes.) 

4.  SURFACE  +X  GOLD:  assigns  the  material  GOLD  (see  Chapter  6.12) 
to  the  surface  of  the  cuboid  whose  normal  points  in  the  +X 
direction.  There  are  up  to  six  surfaces  that  may  be  assigned 
materials  (+X,  -X,  +Y,  -Y,  +Z,  -Z).  All  surfaces  that  will 
eventually  become  a  surface  of  the  finished  object  (rather  than 
become  a  connection  to  another  building  block)  must  be  assigned 
a  material.  (For  surfaces  that  are  shared  with  other  building 
blocks  the  material  assigned  is  ignored.) 


As  an  example,  the  following  cards: 


RECTAN 

CORNER 

-4 

2 

OELTAS 

3 

2  ! 

SURFACE 

♦X 

GOLD 

SURFACE 

♦Y 

GOLD 

SURFACE 

♦Z 

GOLO 

SURFACE 

-X 

GOLD 

SURFACE 

-Y 

GOLD 

SURFACE 

ENDOBJ 

-Z 

GOLD 

define  a  gold  bar  extending  from  -4  to  -1  in  the  X  direction,  2 
in  the  Y  direction  and  -1  to  +4  in  the  Z  direction  (Figure  6/5) 


to  4 


Figure  6.5.  RECTAN. 


6.10.16  PATCHR 


PATCHR  is  defined  in  exactly  the  same  way  as  RECTAN. 

PATCHR 

CORNER  x  y  z 
DELTAS  ax  ay  az 

<SURFACE  card(s)  (usually  just  one)> 

<e.g.,  SURFACE  +X  GOLD 
! ENDOBJ 

PATCHR  should  only  be  defined  within  an  existing  object. (see  6.14). 
6.10.17  WEDGE 


The  following  cards  define  a  right  angled  wedge: 
WEDGE 

CORNER  x  y  z 

FACE  KAPTON  1  1  0 

LENGTH  ax  ay  AZ 

j  SURFACE  +X  TEFLON 

I  <Up  to  four  SURFACE  cards> 

ENDOBJ 


Notes: 

1.  WEDGE:  is  the  building  block  keyword. 

2.  CORNER  x  y  z:  defines  the  lowest  indexed  vertex  of  the  right 
angled  corner  of  the  wedge  (see  note  2,  6.10.15). 

3.  FACE  KAPTON  110:  contains  two  pieces  of  information: 

a.  'KAPTON'  assigns  the  material  KAPTON  to  the  surface  of  the 
face  of  the  wedge.  (The  face  is  the  sloping  surface  of  the 
wedge. ) 

b.  '1  1  O'  defines  the  direction  of  the  normal  to  the  face  and 
hence  the  orientation  of  the  wedge  itself.  The  normal  may  point 
in  any  of  the  following  directions  only: 


•\ 
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t 

V* 

V 
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0  ' 
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r.-. 


f 
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±1,  *1,  0 
li.  0,  +1 
o,  n,  +i 

(For  those  of  you  not  familiar  with  the  *1  1  O'  notation  a 
'1  1  0’  normal  is  a  vector  pointing  to  the  coordinates  X  *  1, 

Y  «  1  and  Z  ■  0  from  the  origin.) 

4.  LENGTH  ax.  Ay,  az:  gives  the  lengths  of  the  sides  of  the  wedge 
parallel  to  the  X,  Y  and  Z  axes.  To  maintain  symmetry  two  of 
these  must  be  equal  ( i . e . ,  the  two  right  triangle  sides). 

5.  SURFACE  +X  TEFLON:  assigns  the  material  'TEFLON'  (Section 
6.12)  to  the  surface  whose  normal  points  in  the  positive  X 
direction.  There  are  up  to  four  remaining  surfaces  that  may  be 
assigned  materials  (see  6.10.15,  note  4).  These  all  have 
normals  pointing  along  one  of  the  axis  directions.  Along  which 
axis  direction  they  point  depends  on  the  orientation  of  the 
wedge  or  the  choice  of  normal  for  the  face  (note  2).  The 
possible  combinations  of  face  directions  and  remaining  surface 
directions  are  summarized  in  Table  6/3.  Cards  defining 
materials  for  non-existent  faces  are  ignored. 

As  an  example,  the  following  cards: 


WEDGE 

CORNER 

0  0 

0 

FACE 

GOLD  1 

LENGTH 

2  2 

2 

SURFACE 

-X 

GOLD 

SURFACE 

-Y 

GOLD 

SURFACE 

+Z 

GOLD 

SURFACE 

-Z 

GOLD 

ENDOBJ 

define  a  wedge  covered  in  gold  with  the  origin  as  one  of  its  corners 
and  a  face  whose  normal  points  between  the  X  and  Y  axes  in  the  XY 
plane.  This  is  shown  in  Figure  6/6. 


6.1-15 


TABLE  6/3.  DIRECTIONS  OF  SURFACE  NORMALS  ASSOCIATED  WITH 
ALLOWED  WEDGE  ORIENTATION 


Normal  of  WEDGE  Face 


Normal?  of  Four  Remainina  Surface? 


6.10.18  PATCHW 


PATCHW  is  defined  in  exactly  the  same  way  as  a  wedge. 

PATCHW 

CORNER  x  y  2 
FACE  GOLD  1  -1  0 
LENGTH  ax  ay  az 

<Up  to  four  SURFACE  cards  (usually  just  one)> 

ENDOBJ 

Like  PATCHR  (6.10.16)  it  may  only  be  used  to  define  a  wedge  inside 
another  building  block.  This  is  explained  further  in  Section  6.14. 

6.10.19  TETRAH 


The  following  cards  define  a  tetrahedron: 
TETRAH 

CORNER  x  y  2 

FACE  ALUMNUM  1  1  -1 


LENGTH 

AX 

SURFACE 

-X 

TEFLON 

SURFACE 

-Y 

TEFLON 

SURFACE 

+Z 

TEFLON 

ENDOBJ 


Notes: 


1.  TETRAH  is  the  building  block  keyword. 

2.  CORNER  x  y  z:  defines  the  coordinates  of  the  right  angled 
corner  of  the  tetrahedron.  There  is  only  one  of  these.  (It 
corresponds  to  the  corner  of  the  partially  filled  cubic  volume 
element  that  is  actually  filled.) 

3.  FACE  1  1  -1:  assigns  the  material  ALUMINUK  to  the  unique 

face  of  the  tetrahedron  opposite  the  right  angled  corner. 

'1  1  -1'  gives  the  direction  of  this  face's  surface  normal  and 

hence  the  orientation  of  the  tetrahedron.  The  following 
directions  only  are  allowed: 

11,  11.  11 

(This  notation  is  the  same  as  explained  in  6.10.17,  note  3.) 


LENGTH  ax:  gives  the  length  of  the  sides  along  the  X,  Y  and  Z 
axis  directions.  (These  must  all  be  equal  to  preserve  symmetry.) 

SURFACE  -X  TEFLON:  assigns  the  material  teflon  to  the 
remaining  surface  with  surface  normal  pointing  along  the 
negative  X  axis  direction.  Up  to  three  surfaces  remain  to  be 
assigned  materials  (see  6.10.15,  note  2).  The  surface  normals 
of  these  surfaces  depend  on  the  orientation  of  the  tetrahedron 
and  hence  the  normal  of  the  "face".  Table  6/4  summarizes  these 
relationships.  Definitions  of  non-existent  surfaces  are  ignored. 


TABLE  6/4.  DIRECTIONS  OF  SURFACE  NORMALS  ASSOCIATED  WITH 
ALLOWED  TETRAHEDRON  ORIENTATIONS 


Normal  of  TETRAHedron  Face 


Normals  of  Three  Remaining  Surfaces 


1 

1 

1 

1 

1 

1 

1 

-1 

1 

1 

1 

-1 

1 

-1 

1 

1 

1 

-1 

1 

-1 

-1 

1 

-1 

-1 

As  an  example,  the  following  cards: 

TETRAH 

CORNER  000 
FACE  KAPTON  1  1  1 

LENGTH  2 

SURFACE  KAPTON  -X 
SURFACE  KAPTON  -Y 
SURFACE  KAPTON  -Z 
ENOOBJ 

define  a  tetrahedron  with  its  right  angle  corner  at  the  origin  and  the 
normal  of  the  opposite  face  pointing  between  the  positive  X,  Y  and  Z 
axes.  This  is  shown  in  Figure  6/7. 

6.10.20  OCTAGON 

The  following  cards  define  a  right  octagonal  cylinder: 

OCTAGON 

AXIS  x  y  z  x'  y'  z' 

WIDTH  w 
SIDE  s 

SURFACE  +  GOLD 
SURFACE  -  GOLD 
SURFACE  C  GOLD 
ENDOBJ 

Notes: 

1.  OCTAGON:  is  the  building  block  keyword. 

2.  AXIS  x  y  z  x'  y'  z':  defines  both  the  direction  of  the 
symmetry  axis  and  the  height  of  the  cylinder.  The  symmetry  axis 
must  be  parallel  to  one  of  the  axis  directions.  Thus  two  of  the 
coordinate  pairs  (x,  x‘),  (y,  y')  and  (z,  z')  must  be 
identical.  For  example. 


would  define  an  axis  that  was  not  parallel  to  the  X,  Y  or  Z 
directions.  However, 

'AXIS  6  3  -2  7  3  -2' 

defines  an  axis  parallel  to  the  X  direction  and  is  acceptable. 

The  height  of  the  cylinder  is  given  by  the  difference  in 
coordinates  along  the  axis  direction.  (For  example,  in  the  case 
above,  the  axis  is  one  mesh  unit  long.) 

3.  WIDTH  w:  gives  the  width  of  the  octagonal  cross-section  of  the 
cylinder  as  w.  If  WIDTH  is  chosen  to  be  odd,  the  axis  must  be 
moved  or  the  sides  of  the  cylinder  will  lie  halfway  across  a 
volume  element.  POLAR  automatically  moves  the  axis  +1/2  a  mesh 
unit  in  each  direction  in'  the  plane  perpendicular  to  it. 

4.  SIDE  s:  gives  the  length  of  one  of  the  sides  of  the  octagonal 
cross-section  that  lies  in  an  axis  direction.  The  symmetry 
relationship  between  the  width  and  the  sides  of  the 
cross-section  is  shown  in  Figure  6/8.  To  maintain  this 
relationship  the  side  must  always  be  an  even  number  of  mesh 
units  less  than  the  width.  This  means  that  they  both  either 
must  be  odd  or  both  even  numbers  of  mesh  units. 

5.  SURFACE  +  GOLD:  assigns  the  material  GOLD  to  the  tO£  surface  of 
the  cylinder.  and  'C*  replacing  the  assign  surface 
materials  to  the  bottom  or  side  cylindrical  surface, 
respectively.  Only  those  surfaces  that  will  eventually  become 
surfaces  of  the  completed  object  need  be  assigned  a  material. 

As  an  example,  the  following  cards: 

OCTAGON 

AXIS  2  -4  6  2  -4  10 

WIDTH  5 
SI0E  3 

SURFACE  +  TEFLON 
SURFACE  -  TEFLON 
SURFACE  C  TEFLON 
ENDOBJ 

defines  a  right  octagonal  cylinder  covered  in  teflon.  The  symmetry 
axis  lies  along  the  Z  direction  and  the  height  of  the  cylinder  is  four 
mesh  units.  Because  the  WIDTH  is  odd  the  axis  is  imagined  to  pass 
through  the  point  2  1/2,  -3  1/2  in  the  X  Y  plane.  Hence  the  top  and 


bottom  faces  run  from  X  *  0  to  X  *  5  and  from  Y  =  -6  to  Y  =  -1 
coordinates  of  the  top  of  the  cylinder  are  shown  in  Figure  6/8 
three-dimensional  view  is  shown  in  Figure  6.9. 


6.10.21  GSPHERE 
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v 


4 


VV*- 


The  following  cards  define  a  quasisphere: 

QSPHERE 

CENTER  x  y  z 
DIAMETER  d 
SIDE  s 

MATERIAL  Si02 
ENDOBJ 

Notes: 

1.  QSPHERE:  is  the  building  block  keyword. 

2.  CENTER  x  y  z:  defines  the  center  of  the  sphere  to  be  at 
coordinates  X,  Y,  Z. 

3.  DIAMETER  d:  defines  the  diameter  of  the  sphere  to  be  d  mesh 
units.  The  quasi  sphere  can  be  thought  of  as  an  octagonal 
cross-section  {like  the  top  of  an  OCTAGON  (see  6.10.20))  rotated 
about  an  axis  in  the  cross-section  plane.  The  diameter  then 
corresponds  to  the  WIDTH  for  a  two-dimensional  octagonal 
section.  The  same  restrictions  then  apply:  An  odd  value  for 
the  DIAMETER  causes  POLAR  to  automatically  move  the  CENTER  by 
+1/2  a  mesh  unit  in  the  X,  Y  and  Z  directions. 

4.  SIDE  s:  sets  the  length  of  a  side  lying  in  one  of  the  axis 
planes  (e.g.,  X  Y  plane).  Like  the  OCTAGON,  the  SIDE  and 
DIAMETER  must  differ  by  an  even  number  of  mesh  units. 

5.  MATERIAL  SI02:  assigns  the  material  SI02  to  the  whole  sphere 
surface. 

As  an  example,  the  following  cards: 

QSPHERE 

CENTER  1  -3  5 
DIAMETER  7 
SIDE  3 

MATERIAL  SILVER 
ENDOBJ 


t . 


v' 


S.V 


V' 

K 


i-; 


,  % 
f- 


,v 


define  a  silver  sphere  centered  at  1  1/2,  -2  1/2  and  5  1/2 
sphere  extends  along  the  axis  direction  as  follows: 
x  from  -2  to  5 
y  from  -6  to  1 
z  from  2  to  9 

(See  Figure  6/10.) 


Figure  6/10.  QSPHERE . 


^AD-A154  125 

PRELIHINARV  DOCUMENTATION  FOR  THE 

POLAR  CODE(U) 

S-CUBED 

2/2 

UNCLASSIFIED 

Lfl  JOLLA  CA  I  KATZ  ET  AL.  JUL  84 
AFGL-TR-82-0194  F19628-82-C-0081 

SSS-R-83-602? 

F/G 

4/1 

NL 

6.10.22  FIL111 


The  following  cards  define  a  FIL111: 
FILlll 

CORNERLINE  x  y  z  x*  y*  z' 
FACE  KAPTON  1  -1  -1 
ENDOBJ 


Notes: 

1.  FILlll:  is  the  building  block  keyword. 

2.  CORNERLINE  x  y  z  x‘  y*  z':  defines  both  the  length  and  the 
direction  of  the  "step"  FILlll  is  to  fill.  The  line  must  lie  in 
one  of  the  axis  planes  (XY,  XZ,  YZ)  and  must  have  a  direction 
lying  45°  to  two  of  the  axes.  This  means  that  one  pair  of  the 
coordinates  (x*.  x),  (y,  y * )  (z,  z')  must  be  identical  and  the 
other  two  pairs  must  differ  by  the  same  magnitude.  For  example, 

•CORNERLINE  123  456* 

is  unacceptable  since  all  three  coordinate  pairs  change.  The 
following  correct  example 

'CORNERLINE  123  -143’ 

defines  a  line  in  the  XY  plane  (Z  is  constant)  with  ax  «  -2,  and 
ay  »  +2.  Hence  the  line  is  2/7  units  in  length  and  runs  at  45* 
between  the  positive  Y  axis  and  the  negative  X  axis. 

3.  FACE  KAPTON  1  -1  -1:  assigns  the  material  KAPTON  to  the 
exposed  surfaces  of  the  FILlll  and  defines  its  orientation  via 
the  surface  normal  of  its  exposed  face:  1  -1  -1.  The  surface 
normal  can  only  be  combinations  of 

+1  +1  +1 

Only  certain  choices  of  corner  line  direction  are  consistent 
with  each  choice  of  FACE  normal.  If  we  subtract  the  x  y  z, 
x'  y'  z'  coordinates  defined  in  corner  line 

ax  *  x'  -  x 
Ay  =  y’  -  y 
az  »  z'  -  z 

then  the  surface  normal  n^  n2  n3  (e.g.,  1  1  1)  must  be 
orthogonal  to  ax,  ay,  az,  i.e., 

ax  •  nj  +  Ay  •  n 2  +  az  *  n3  .  0. 


With  the  choice  123  -1  4  3  for  the  corner  line 

coordinates  only  1  1  +1  or  -1  -1  +1  faces  are  permissible, 
e.g., 

.  -2.  -1  +  2.  -1  +  0.  +1  -  0. 

However,  with  -1  +1  +1 

-2.  -1  +  2.1  +  0.  +1  -  4 

the  vectors  are  not  orthogonal  and  so  are  not  allowed. 

As  an  example,  the  following  cards: 

FIL111 

CORNERLINE  14-6  17-3 

FACE  GOLD  -1  1  -1 
EN00BJ 

defines  a  FILlll  covered  with  gold  smoothing  a  step  with  a  corner  line 
running  from  1  4  -6  in  the  YZ  plane,  between  the  positive  Y  and  Z 
axis  to  1  7  -3.  The  face  of  the  FILlll  points  in  the  negative  X  and 
Z  directions  and  positive  Y  direction.  (See  Figure  6/11.) 


Figure  6/11.  FILlll. 
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6.10.23  PLATE 


The  following  cards  define  a  PLATE: 


PLATE 

CORNER 

OELTAS 

TOP 


BOTTOM 

ENDOBJ 


x  y  z 


ax  ay 


az 


ALUMIN 


KAPTON 


6.1-28 


Notes: 


1.  PLATE:  is  the  building  block  keyword. 

2.  CORNER  x  y  z:  defines  the  vertex  of  the  thin  plate  with  the 
lowest  indices  (see  6.10.15,  note  2). 

3.  DELTAS  ax  ay  az:  defines  the  length  of  the  plate  along  the 
three  axis  directions,  A  PLATE  may  be  thought  of  as  a  cuboid 
(or  RECTAN)  (see  6.10.15)  with  zero  thickness  in  one  direction. 
Hence  one  of  ax,  ay  and  az  must  be  zero.  For  example,  if  ay  is 
chosen  to  be  zero  the  PLATE  will  lie  in  the  xz  plane. 

4.  /X  v 

TOP  +  lY  j  ALUMIN: 

assigns  the  material  ALUMIN  to  the  TOP  surface  of  the  plate. 

The  "TOP"  surface  may  be  either  in  a  +  or  -  axis  direction. 

This  choice  is  arbitrary  unless  a  "double  point"  conflict  is 
possible.  Double  point  conflicts  are  explained  in  Section 
6.11.11. 

5.  /X\ 

BOTTOM  +1  Y  j  KAPTON: 

assigns  the  material  KAPTON  to  the  other  side  of  the  plate.  If 
"top"  were  chosen  as  +X  then  bottom  must  be  -X,  and  so  on.  Note 
that  the  choice  of  x,  y  or  z  must  coincide  with  the  ax,  ay  or  az 
chosen  to  be  zero. 


6.1-2 

As  an  example,  the  cards 
PLATE 

CORNER  OOO 
OELTAS  022 
TOP  -X  TEFLON 
BOTTOM  +X  GOLD 
ENOOBJ 

defines  a  2  x  2  thin  plate  with  gold  on  the  +X  side  and  teflon  on  the 
-X  side  lying  in  the  YZ  plane,  (See  Figure  6/12.) 


Figure  6/12.  PLATE. 
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6.10.24  SLANT 

The  SLANT  object  should  be  thought  of  as  a  WEDGE  with  the 
100-type  surfaces  left  undefined.  The  FACE  card  Is  transformed  to  a 
TOP  card,  and  a  BOTTOM  card  Is  added.  The  CORNER  Is  remote  from  the 
slanted  plate,  and  Is  where  the  CORNER  of  a  WEDGE  would  be  If  we  were 
defining  the  FACE  of  a  WEDGE.  Similarly,  the  LENGTH  card  corresponds 
to  that  of  a  WEDGE.  The  syntax  is 
SLANT 

CORNER  ix  jy  kz 
TOP  matl  nx  ny  nz 
BOTTOM  matl 
LENGTH  lx  ly  lz 
ENDOBJ 

6.10.25  MORE  OBJECT  DEFINITION  KEYWORDS 

In  addition  to  the  building  block  keywords  and  the  parameter 
cards  that  follow  VEHICL  also  recognizes  a  few  other  keywords.  With 
these  and  the  building  blocks  a  complete  object  definition  file  can 
finally  be  constructed.  Let  us  examine  the  remaining  keywords  and 
their  effect  one  by  one. 

ENDSAT 

Just  as  ENDOBJ  terminates  a  set  of  building  block  parameter 
cards,  so  the  keyword  'ENDSAT'  terminates  the  whole  object  definition 
file.  After  reading  an  'ENDSAT'  card  VEHICL  stops  trying  to  read  any 
more  keywords  from  the  object  definition  file  and  begins  to  process 
the  information  it  has.  Note  that  AU  object  definition  files  must 
end  with  an  'ENDSAT'  card. 


ms 


I 


■ 


PfHvoC 


CO  WENT 


VEHICL  ignores  anything  written  on  the  same  80  character  line 
(or  card)  that  begins  with  the  keyword  'COMMENT'.  This  allows  the 
user  to  include  notes  or  reminders  in  long  and  complicated  object 
definition  files,  e.g.. 


COMMENT  DEFINE  OCTAGONAL  BODY 
OCTAGON 

AXIS  -6  0  2  -8  0  2 


OFFSET 


The  card 

OFFSET  x  y  z 

relabels  the  grid  center  to  be  (NX+l)/2-X,  (NY+l)/2-Y,  (NZ+l)/2-2, 

9-x,  9-y,  17-z  for  a  17  x  17  x  35  inner  grid.  The  so-called 
"absolute"  POLAR  coordinate  system  labels  the  axes  from  1  to  17  in  the 
X  and  Y  direction  and  1  to  33  in  the  Z  direction.  In  this  "absolute 
system"  the  center  of  the  grid,  which  we  had  previously  labeled 
(0,  0,  0,)  becomes  (9,  9,  17).  So  we  may  move  from  the  more  intuitive 
(0,  0,  0)  centered  system  to  the  "absolute"  system  with  the  command 
OFFSET  000 

To  illustrate  the  difference  the  following  two  sets  of  cards  define  a 
sphere  centered  at  the  center  of  the  grid. 


Default  coordinate  system  Absolute  coordinate  system 


QSPHERE 
CENTER  000 
DIAMETER  7 
SIDE  3 

MATERIAL  KAPTON 
ENDOBJ 


OFFSET  000 
QSPHERE 
CENTER  9  9  17 
DIAMETER  7 
SIDE  3 

MATERIAL  KAPTON 
ENDOBJ 


The  coordinate  system  may  be  adjusted  with  the  OFFSET  command  anytime 
at  any  point  between  building  blocks.  The  active  system  is  always  the 
default  or  the  coordinate  system  defined  by  the  most  recent  OFFSET. 

CONDUCTOR 

POLAR  allows  for  both  insulating  and  conducting  materials 
(Chapter  6.12).  It  assumes  that  all  surface  materials  cover  an 
underlying  conductor.  Up  to  15  separate  conductors  are  allowed.  Each 
building  block  is  associated  with  a  particular  conductor.  This 
association  is  made  by  preceding  all  building  block  definitions 
associated  with  the  first  conductor  with  the  card: 

CONDUCTOR  1 

Similarly,  blocks  associated  with  a  second  conductor  are  preceded  by 
the  card 

CONDUCTOR  2 

and  so  on.  If  no  CONDUCTOR  card  is  included  in  the  object  definition 
file  all  building  blocks  will  be  associated  with  CONDUCTOR  1.  In  the 
same  way  any  building  blocks  defined  before  VEHICL  encounters  a  card 
CONDUCTOR  n  (n  >  1) 

will  be  associated  with  conductor  1.  All  subsequent  blocks  will  be 
associated  with  conductor  n,  until  another  conductor  card  is 
encountered . 


It  is  conventional  to  choose  conductor  1  as  the  satellite  ground 
conductor.  Skipping  conductor  numbers  is  not  recommended. 


•V-W-'-V.  .•« 


DELETE  allows  the  user  to  modify  building  blocks  alreaoy  defined 
by  selectively  "deleting"  filled  or  partially  filled  cells  (i.e., 
"deleting"  them  by  making  them  errpty). 

DELETE  x  y  z 

empties  the  filled  cell  with  the  indices  of  its  lowest  index  vertex 
given  by  x  y  z.  (The  lowest  index  vertex  is  the  one  with  the  sum  of 
its  X,  Y  and  Z  coordinates  equal  to  the  least  positive  number.)  The 
coordinates  x,  y,  z  refer  to  the  coordinate  system  presently  active 
(i.e.,  the  default  system  or  that  associated  with  the  most  recent 
OFFSET  command).  The  DELETE  command  requires  great  care  in  its  use. 

It  does  not  assign  materials  to  surfaces  that  are  newly  exposed  by  the 
removal  of  a  filled  element.  The  user  must  do  this  by  defining  a  new 
object  or  objects  with  surfaces  that  coincide  with  those  newly 
exposed.  This  is  most  easily  done  by  overlaying  objects  (6.14). 

COMPRESS 

Since  there  is  a  limit  of  1250  to  the  number  of  surfaces  on  an 
object  (the  rectangle  defined  in  Figure  6/5  has  62  surfaces),  large 
complex  objects  sometimes  contain  interior  surfaces  which  need  to  be 
removed.  Normally  these  surfaces  are  removed  when  the  satellite 
definition  is  complete  or  when  the  number  of  surfaces  exceeds  the 
surface  limit  between  building  blocks,  COMPRESS  forces  the  existing 
interior  surfaces  to  be  removed  immeoiately.  An  example  of  the  syntax 
is 


ENDOBO 

COMPRESS 


MARKTB 
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Sometimes  when  defining  odd  objects  with  unusual  geometries, 
undefined  double  points  will  be  found.  One  way  to  patch  the  object  is 
to  use  the  MARKTB  command  to  define  an  element  and  its  associated 
surfaces  to  be  TOPS  or  BOTTOMS. 

MARKTB  1  2  2  TOP 

MARKTB  1  2  1  BOTTOM 

The  first  MARKTB  command  forces  the  cell  with  lowest  index 
vertices  of  (1,2,2)  to  be  marked  as  a  TOP  element.  The  second  line 
marks  the  element  below  the  first  in  the  Z-direction  as  a  BOTTOM 
cell.  It  should  be  noted  that  these  index  vertices  will  be  affected 
by  previous  OFFSET  commands.  (See  Section  6.11.11  for  more  hints  for 
dealing  with  double  points.) 

OTHER  WORDS 

Any  other  words  that  VENICE  reads  in  the  object  definition  file 
are  assumed  to  be  the  names  of  new  materials  and  VEHICL  then  expects 
three  more  cards  defining  the  material  properties  (6.12)  to  follow 
immediately. 

6.11  DEFINING  AN  OBJECT:  AN  EXAMPLE 

The  input  file  of  Figure  6/13  defines  an  object  consisting  of  an 
ALUMINUM  slab,  trimmed  with  four  KAPTON  wedges  and  four  TEFLON 
tetrahedra,  and  topped  with  a  GOLD  sphere.  Three  views  of  the 
resulting  object  are  shown  in  Figure  6/14. 
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COMMENT  ALUMINUM  SLAB 
=  E  C  T  A  N 

CORNER  -3  -4  -1 
DELTAS  661 
SURFACE  *Z  A LU“  I ^U** 

SURFACE  -*  ALUMINU** 

ENCOB- 

COMMENT  FOUR  KAPTCN  WEDGES 
■  EDGE 

CORNER  -3  -4  -1 
FACE  KAPTON  -1  C  1 
LENGTH  1  8  1 
SURFACE  -2  KAPTCN 
ENOOBJ 
6E0GE 

CORNER  -3  -4  -1 
FACE  KAPYCN  C.  -1  1 
LENGTH  6  1  1 
SURFACE  -2  KAPTCN 
ENOOBJ 

kEC6|oRNER  3  -4  -1 

FACE  KAPTON  l  3  1 
LENGTH  1  8  1 
SURFACE  -2  KAPTCN 
ENCOS J 
WEDGE 

CORNER  -3  •  -1 
FACE  KAPTON  3  1  1 
LENGTH  6  1  l 
SURFACE  -2  KAPTCN 
En^OBj 

COMMENT  FOUR  TEFLON  TETRAHEPPA 

tetrahedron 

CORNER  - J  -4  -1 
RACE  TEFLON  -1  -1  l 
LENGTH  1 
SURFACE  -2  TEFLON 
ENOOBJ 
tetrahedron 

CORNER  *  -4  -l 
FACE  TE?LCN  1  -1  l 
LENGTH  1 
SURFACE  -2  TEFLON 
ENOOBJ 
TETRAHEDRON 

CORNER  34-1 
FACE  TEFLON  1  l  1 
LENGTH  1 
SURFACE  -2  TEFLON 
ENOOBJ 
tetrahecrcn 

CORNER  -J  4  -1 
FACE  TEFLON  -1  1  1 
LENGTH  1 

surface  -z  teflcn 

ENOOBJ 

COMMENT  ALL  TOPPED  3  V  A  GOLD  SPHERE 
CSRHERC 

CENTER  Z  Z  2 
DIAMETER  <* 

SICE  2 

material  GOLD 

ENC08J 

ENOSAT 


CUBOID 


FOUR  WEDGES 


FOUR 

TETRAHEDRA 


SPHERE 


Figure  6/13.  Object  definition  example. 


6.11.10  LIMITATIONS  IN  OBJECT  DEFINITION 
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It  is  probably  fair  to  say  that  you  can  link  building  blocks 
together  and  nine  times  out  of  ten  there  will  not  be  a  problem.  This 
section  deals  with  the  other  one  time  out  of  ten,  when  what  appears  to 
be  a  perfectly  reasonable  combination  of  building  blocks  is  rejected 
by  VEHICL.  We  itemize  here  a  rather  formidable  list  of  object 
definition  "dcn'ts".  However,  you  should  remember  that  it  takes  hard 
work  to  break  more  than  one  or  two  of  these  rules  defining  any  one 
object  if  you  use  a  little  common  sense. 


1.  All  exposed  surfaces  must  be  assigned  materials. 

2.  The  parameter  cards  for  each  building  block,  discussed  in 
Section  6.10.14,  must  appear  in  the  order  shown,  and  no  other. 

3.  The  object  must  not  touch  the  object  grid  boundary  planes  at  any 
point. 

4.  Thin  plates  sharing  the  same  volume  element  can  do  so  only  if 
the  TOP  face  of  one  shares  volume  with  the  TOP  of  the  other,  or 
the  BOTTOM  face  of  one  shares  volume  with  the  BOTTOM  face  of  the 
other.  TOP  faces  may  not  share  volume  elements  with  BOTTOM 
faces. 

5.  Thin  plates  may  only  intersect  each  other  at  the  edges  or 
corners. 

6.  Double  points  must  be  assigned  TOP  and  BOTTOM  sets  (see  Section 

6.11.11). 

(Rules  4  through  6  are  all  manifestations  of  conflicts  involving 

double  and  triple  points.) 


6.11.11  DOUBLE  POINTS 


Thin  plates  may  have  different  potentials  on  their  two  surfaces, 
yet  they  occupy  only  one  plane  of  grid  points.  These  grid  points  must 
therefore  be  associated  with  two  distinct  sets  of  potentials.  For 
this  reason  they  are  called  double  points.  The  two  sets  of  potentials 
associated  with  each  half  of  the  double  points  are  distinguished  by 
calling  one  set  'TOP'  and  one  set  'BOTTOM'.  Recall  (6. 1C. 23)  that  the 


surfaces  of  a  thin  plate  may  be  defined  as  'TOP'  or  'BOTTOM' 
regardless  of  whether  their  surface  normal  points  along  a  positive  or 
negative  axis  direction:  The  TOP  and  BOTTOM  definition  refers  to  the 
(arbitrary)  choice  of  which  set  of  potentials  (TOP  or  BOTTOM)  to 
associate  with  each  surface.  When  double  points  share  a  volume 
element  they  must  all  be  of  the  same  type;  i.e.,  all  TOP  or  all 
BOTTOM.  This  is  the  basis  for  rule  4  in  Section  6.11.10. 

Double  points  also  occur  when  other  building  blocks  touch  in 
such  a  way  that  their  single  points  come  together  to  form  a  common 
vertex  of  two  "disjoint"  volume  elements.  By  "disjoint"  volume 
elements  we  mean  elements  physically  separated  from  each  other  by 
solid  surfaces.  This  is  shown  for  two  cuboids  touching  along  one  edge 
only  in  Figure  6/15.  The  row  of  points  along  the  touching  edges  are 
double  points  and  one  set  must  be  defined  as  BOTTOM.  This  may  be  done 
by  defining  a  thin  plate  touching  the  common  edge.  If  the  exterior 
surface  of  the  plate  pointing  into  one  of  the  disjoint  volumes  is 
'BOTTOM'  then  the  half  of  the  double  point  associated  with  the  other 
disjoint  volume  becomes  'TOP'. 


X 


Figure  6/15.  Profile  of  two  cuboids  sharing  a  common  edge  and 

resultant  double  points.  Heavy  lines  show  possible 
orientations  for  the  definition  of  a  thin  plate  to  re¬ 
solve  the  conflict. 


Because  of  the  way  surface  cell  potentials  are  assigned  to  grid 
points,  the  edges  of  thin  plates  are  only  single  points.  However,  a 
thin  plate  touching  another  building  block  with  its  edge  creates  a  row 
of  double  points  similar  to  that  caused  by  two  cuboids  touching  at  an 
edge  (Figure  6/16).  These  double  points  are  automatically  assigned 
TOP  and  BOTTOM  sets. 

Double  point  ambiguities  can  also  be  resolved  on  an  element  by 
element  basis  using  the  MARKTB  command  discussed  in  Section  6.10.25. 

6.11.12  TRIPLE  POINTS 

A  triple  point  is  said  to  occur  when  a  vertex  is  common  to  three 
or  more  disjoint  volume  elements.  Triple  points  are  illegal!  The 
easiest  way  to  get  a  triple  point  is  to  define  one  thin  plate  passing 
through  another.  This  is  not  allowed  (rule  5,  Section  6.11.10). 


Bottom 


Bottom 


VALID 


INVALID 


Top 

Bottom 


Top 

Bottom 


Bottom 

Top 


Top 

Bottom 


VALID 


INVALID 


,  Jqjl. 

Bottom 


» 

INVALID  (Contains 
triple  point) 


Figure  6/16.  Examples  of  plates  intersecting  objects 


Bottom 
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6.12.10  MATERIAL  PROPERTIES 

Each  material  name  (e.g.,  KAPTON,  GOLD,  FRED  (the  name  is 
arbitrary))  has  associated  with  it  a  list  of  material  properties.  The 
name  of  each  material  and  the  values  for  each  material  property  are 
supplied  by  the  user  in  the  object  definition  file.  (This  is 
explained  in  Section  6.12.11.)  The  nineteen  material  properties  are 
summarized  in  Table  6/5.  Here  we  examine  each  one  in  more  detail. 

DIELECTRIC  CONSTANT  (PROPERTY  1) 

Property  1  contains  the  relative  dielectric  constant  for  an 
insulating  material  cr 


e 


where  c  is  the  absolute  dielectric  constant  and  eQ  is  the  dielectric 
constant  of  free  space.  cf  is  dimensionless. 

THICKNESS  (PROPERTY  2) 

Property  2  gives  the  thickness  d  of  a  dielectric  film  covering 
an  underlying  conductor  in  meters,  d  is  arbitrary  and  may  be  chosen 
to  be  more  or  less  than  a  mesh  unit.  However,  note  that  POLAR  uses 
thin-film  approximations  in  many  of  its  calculations  involving 
surfaces  (Section  4.52). 

BULK  CONDUCTIVITY  (PROPERTY  3) 

Property  3  gives  the  bulk  conductivity  oQ  of  the  surface 
material  in  ohms-*  m_*.  a0  is  assumed  to  be  the  value  appropri¬ 
ate  for  a  sample  not  exposed  to  any  radiation  and  not  subject  to  any 
internal  electric  fields.  Field  enhancement  and  radiation  enhancement 
of  oQ  are  not  currently  modeled  by  POLAR.  A  value  of  -1  indicates 
that  the  material  is  a  metallic  conductor. 


Property  No. 


TABLE  6/5.  MATERIAL  PROPERTIES 
(see  Section  6.12.10  for  notes) 


User  Input  Units  Description 

None  Relative  dielectric  constant 


m 

Dielectric  material  thickness 

ohms"*  m~* 

Bulk  conductivity  (■  -1  for  a 
metallic  conductor) 

None 

Atomic  number 

None 

Maximum  secondary  electron  yield 
for  electron  impact 

keV 

Primary  electron  energy  that 
produces  maximum  secondary  yield 

angstroms 

None 

angstroms 

None 

(Range  parameters  (4.3) 

(R  .  P7EP8  +  r9EP10 

None 

keV 

A  m-2 

ohms  square"* 
Volts 


Secondary  electron  yield  due  to 
impact  of  1  keV  protons 

Incident  proton  energy  that 
produces  maximum  secondary  electron 
yield 

Photoelectron  yield  for  normally 
incident  sunlight 

Surface  resistivity  («  -1  for 
non-conducting  surface) 

Maximum  (absolute)  potential 
attainable  before  a  discharge  must 
occur 


Volts 


ohms-*  m~* 
(m2  s"3)"* 


Maximum  potential  difference 
between  surface  and  underlying 
conductor  before  a  discharge  must 
occur 

Radiation-induced  conductivity 
coefficient  (k) 


None 


kg  nr3 


Radiation-induced  conductivity 
power  (a) 


Material  density 


ATOMIC  NUMBER  (PROPERTY  4) 


Property  4  is  the  atomic  number  for  pure  elements  or  the  mean 
atomic  number  for  chemical  compounds;  e.g.,  polyethylene  (CHg )n 
has  a  mean  atomic  number  of  (6  +  1  +  l)/3  »  2.7. 

SECONDARY  YIELD  (PROPERTIES  5  ANO  6) 

Properties  5  and  6  are  the  coordinates  of  the  maximum  in  the 
secondary  electron  yield  curve  of  the  material.  The  secondary  yield 
curve  is  a  plot  of  secondary  yield  « 

current  of  secondary  electrons  emitted 
6  *  incident  primary  electron  current 


for  normally  incident  electrons,  against  the  incident  energy  of  the 

primary  electron  E.  This  is  further  discussed  and  illustrated  in 

Section  4.52.  Property  5  contains  «max,  and  property  6  contains 

E  in  keV. 
max 

ELECTRON  RANGE  (PROPERTIES  7,  8,  9  AND  10) 


Part  of  the  secondary  electron  emission  formulation  requires  an 
analytical  form  for  the  "range"  of  electrons  in  the  material.  The 
range  is  the  depth  to  which  the  electrons  can  penetrate  the  material 
as  they  are  continuously  slowed  down  by  losing  energy  to  the  material 
lattice.  POLAR  uses  a  biexponential  form.  If  P 7,  Pg,  Pg,  and 
Pjq  are  properties  7-10  respectively,  the  range  R  is  given  by 

r  m  p^  E  ®  +  Pg  E  ^ 


The  four  parameters  are  obtained  from  fits  to  stopping  power  data 

0  -10 

(Section  4.52).  The  range  is  determined  in  A  (10  m).  If  no 
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reliable  stopping  power  data  or  four  parameter  fits  are  available,  the 
range  may  be  estimated  from  Feldman's  formula^  automatically  by 
assigning  -1  to  property  7.  In  this  mode  properties  7-10  are  assigned 
as  follows: 


PQ  ■  null 

o  o 

Pg  ■  material  density  (g  cm  ) 

Pjq  *  mean  atomic  weight  (AMU) 

The  mean  atomic  weight  is  calculated  in  the  same  way  as  the  mean 
atomic  number  (property  4)  using  atomic  masses  rather  than  numbers. 

ION  INDUCED  SECONDARY  EMISSION  (PROPERTIES  11  AND  12) 

Secondary  emission  of  electrons  due  to  ion  impact  is  also 
treated  using  a  two  parameter  theory  (4.52).  Parameter  11  contains 
the  yield  for  1  keV  normally  incident  protons  and  parameter  12  the 
proton  energy  that  produces  the  maximum  electron  yield.  The  secondary 
emission  properties  due  to  impact  of  ions  other  than  protons  are 
assumed  to  be  identical  to  the  proton  values. 

PHOTOEMISSION  (PROPERTY  13) 

Property  13  contains  the  yield  of  photoelectrons  from  the 
surface  material  exposed  to  the  solar  spectrum.  The  intensity  is  that 
measured  on  earth  93,000,000  miles  from  the  sun.  (Earth  orbit 
altitudes  are  negligible  by  comparison  and  the  intensity  of  the  sun 
close  to  earth  may  be  considered  constant.) 


SURFACE  RESISTIVITY  (PROPERTY  14) 

Property  14  gives  the  intrinsic  surface  resistivity  in  the  "ohms 
per  square".  This  rather  odd  unit  Is  used  to  distinguish  the 
resistivity  coefficient  (property  14)  from  the  actual  surface 
resistance  (in  ohms)  calculated  by  POLAR.  Consider  two  points  in  a 
plane  A  and  B,  a  distance  apart.  If  is  the  "width"  of  the 
plane 

surface  resistance  ■  surface  resistivity  x  t-=- 

l2 

dimensionless 

i.e.  ohms  *  (ohms  per  square)  x  geometrical 


POLAR  uses  the  surface  resistivity  per  square,  times  a  geometrical 
factor  it  calculates  to  determine  the  surface  resistance  between  two 
adjacent  materials. 

The  intrinsic  surface  conductivity  is  due  to  the  migration  of 
electrons  along  the  surface  layer  aided  by  adsorbed  impurities  and 
defects. 

Surface  conductivity  may  be  omitted  from  the  current 
calculations  completely  by  choosing  property  14  to  be  negative. 

DISCHARGE  ANALYSIS  (PROPERTIES  17,  18,  19,  20) 

Currently  under  development. 

PROPERTIES  17,  18,  19,  20  (RADIATION  INDUCED  CONDUCTIVITY) 

Currently  under  development. 

6.12.11  DEFINING  MATERIALS 

New  materials  are  defined,  and  their  properties  assigned  inside 
the  object  definition  file  (6.10.11).  The  object  definition  file  is 
read  by  POLAR  module  VEHICL.  VEHICL  interprets  any  word  that  it  does 
not  recognize  as  a  buildirg  block  keyword  (or  their  parameter  cards 
(6.10.25))  as  the  definition  of  a  new  material  name.  New  material 
names  may  not  appear  insice  building  block  definitions  (i.e.,  between 
a  building  block  keyword  and  an  'ENDOBJ'  statement). 


Following  the  material  name,  VEHICl  expects  to  find  three 
additional  cards  specifying  20  constants  as  the  material  properties  to 
be  associated  with  the  name.  The  20  constants  correspond  to  properties 
1-20  and  are  read  sequentially;  i.e.,  the  first  constant  read  is  inter¬ 
preted  as  property  1,  the  second,  property  2,  and  so  on.  They  are 
arranged  sequentially,  eight  per  card,  so  that  cards  1  and  2  each  have 
eight  numbers  and  card  3,  four  numbers.  Formally  each  number  is 
written  in  a  field  of  up  to  ten  characters,  but  POLAR  will  read  the 
cards  in  free  format.  No  units  need  be  specified.  POLAR  will  assume 
the  units  given  in  Table  6/5  and  no  others.  For  properties  not 
requiring  any  input  such  as  property  20,  or  properties  17-19  for 
conductors,  some  constant  must  be  entered  but  its  value  is  arbitrary. 
(POLAR  will  not  actually  use  the  values  entered  but  expects  to  read 
something. ) 

Once  the  three  material  property  cards  have  been  read  VEhICL  is 
ready  to  accept  any  other  keywords  or  more  material  names.  POLAR  will 
recognize  up  to  fifteen  different  materials. 

Materials  must  be  defined  before  they  are  referred  to  in  any 
building  block  definition.  For  example,  if  I  assign  the  surface  of  a 
sphere  to  be  'FSTUFF'  with  the  card 

MATERIAL  FSTUFF 

if  'FSTUFF'  and  its  material  properties  have  not  been  declared  earlier 
in  the  object  definition  file,  an  error  will  occur  and  execution  will 
stop.  For  this  reason  all  the  materials  to  be  used  are  usually 
declared  at  the  very  beginning  of  the  object  definition  file.  This  is 
shown  in  Figure  6/17. 


COMMENT  DEFINITION  OF  SATELLITE  "BIG  EARS" 

Material  Name  1 
3  material  property  cards 

Material  Name  2 
3  material  property  cards 

• 

COMMENT  DEFINE  MAIN  BODY 

CONDUCTOR  1 

QSPHERE 

parameter  cards 
ENDOBJ 

RECTAN 

parameter  cards 
ENDOBJ 

.  more  building  blocks 
• 

COMMENT  DEFINE  SOLAR  PANEL  (SEPARATE  CONDUCTOR) 

CONDUCTOR  2 

PLATE 

parameter  cards 
ENDOBJ 

.  more  building  blocks 
• 

COMMENT 
CONDUCTOR  3 

.  more  conductor  segments 
• 

ENDSAT 

Figure  6/17.  General  form  of  the  object  definition  fil 


6.12.12  DEFAULT  MATERIALS 


There  is  one  case  where  the  user  can  forget  to  define  his  or  her 
materials  and  get  away  with  it.  When  VEHICL  encounters  a  material 
that  hasn't  been  defined  already,  before  an  error  occurs,  it  checks 
the  following  list  of  default  materials: 

ALUM IN 

AQUADG 

CPAINT 

GOLD 

INDOX 

MAGNES 

SCREEN 

KAPTON 

NPAINT 

SI02 

SOLAR 

TEFLON 

SILVER 

If  the  material  is  included  in  this  list,  it  becomes  one  of  the  up  to 
fifteen  defined  materials  and  its  properties,  stored  internally,  are 
automatically  entered  as  VEHICL  input  by  the  code.  The  properties  of 
these  materials  are  shown  in  Table  6/6.  Any  further  reference  to  the 
material  will  assign  the  same  set  of  properties  to  the  surfaces 
concerned.  If  the  material  is  not  found  in  this  list,  an  error  will 
occur.  These  material  properties  are  currently  a  carryover  from 
NASCAP.  New  default  materials  will  be  included  in  future  revisions. 

If  two  sets  of  material  properties  are  defined  with  the  same 
name,  or  names  with  the  same  first  four  letters,  two  of  the  fifteen 
possible  materials  are  used  up  but  only  the  first  set  of  material 
properties  are  used.  For  example,  if  GOLD  is  referenced  before  it  is 
defined  in  the  runstream,  the  default  material  properties  of  gold  will 
be  associated  with  aJJ  9old  surfaces  in  the  object  definition  file. 


6.1-50 


TABLE  6/6 

MATERIAL  PROPERTIES 


MATERIAL  1:  ALU* 


RRORERTY 

input  VALUE 

2C0E  VAL-E 

1 

DIELECTRIC  CONSTANT 

i.:o*ooc 

( NONE  1 

1.53*022 

(NONE t 

2 

thickness 

1.30-20! 

“£TE°S 

i. 50-002 

■ESH 

I 

conductivity 

-I.Cr*C00 

■HC/H 

*1.20*000 

■HO/" 

* 

ATOMIC  NUH8E9 

1.3C*CC1 

(NONE ) 

1.39*001 

(NONE) 

5 

DELTA  HAX  >C9EFF 

9.70-031 

(NONE) 

9.16*300 

(NONE! 

6 

E-PAX  >0EPTh»»-1 

3.00-001 

K  E  V 

3.00-002 

ANG-C1 

7 

range 

l.S«»0C2 

ANG. 

1.23*002 

ang. 

S 

EXPONENT  >  RANGE 

S. 00-301 

(NONE ) 

3.67*002 

ANG. 

9 

RAN6E  >  EXPONENT 

2.20*002 

ANG. 

b .20—30 1 

(NONE) 

10 

EXPONENT 

:.T6*coo 

(NONE) 

1.76*020 

(NONE) 

11 

YIEtO  FjR  IK cV  PROTONS 

2. ““-001 

(NONE  1 

2. *.*-031 

(NONE ) 

12 

MAX  OE/OX  FOR  PROTONS 

z.ir*i 02 

K  £  V 

2.33*032 

K£v 

13 

PHOTO CUR ®ENT 

“.30-225 

A/M“*2 

“ . 20-235 

a/-“»3 

1* 

SURFACE  RESISTIVITY 

-:.jo»:cc 

OH"S 

-S. 65-211 

V- S/S 

IS 

SPACE  0ISCHAR3E  “OT*L 

1.30*03“ 

VOLTS 

1.52*20“ 

VCLTS 

16 

IN  T£RN  A(.  3  ISCMAAGEPOT'L 

2.:C*C32 

VOLTS 

2.32*023 

volts 

IT 

RAON  INOUCEOCONO'YCOEFFT 

;.CfJ-Ci3 

NHCHS3 

1.52-311 

"MOHS! 

16 

RAO.N  INOUCEOCONC'YPOkER 

1.23*302 

(NONE) 

1.52*002 

(NONE) 

19 

CtNSITY 

1.00*001 

KG/NPJ 

1.30*003 

K6/n»3 

20 

2.20*001 

-1.00*000 

“aTERIAL  2:  ACUA 

PROPERTY 

INPUT  VALUE 

CODE  VALUE 

1 

OIElECTRIC  constant 

1.30*000 

(NONE) 

1.39*030 

(NONE) 

«. 

thickness 

1.2C-C33 

■eters 

1.0C-232 

■ESh 

t 

CONDUCTIVITY 

-i.;c*cc: 

■hC/" 

-l.33.CCC 

*MC  /  ■ 

« 

ATOMIC  NUMBER 

o. 32*000 

(ncnei 

».52*ccr 

INCNE) 

S 

CEUTA  max  >coeff 

1.20*030 

(NONE) 

7 .56*052 

(NONE) 

6 

E-"AX  >OEPThk«-i 

3.22-001 

K  EV 

2.21-C02 

ANG— C 1 

7 

range 

-1.20*030 

ANG. 

5 .62*002 

ANG  . 

8 

exponent  >  Range 

.32 

(NONE) 

.50 

*NG. 

9 

RANGE  >  EXPONENT 

2 . JC  *C3C 

ANG  • 

1.55*232 

(NONE) 

10 

EXPONENT 

1.23*001 

(NONE  1 

1.22*000 

(NONE) 

11 

»IEL3  FOR  IkEV  ppqtons 

“.55-021 

INCNE  ) 

“.55-201 

(NONE ) 

12 

■AX  OE/OX  FOR  PROTONS 

1. “0**32 

"Ev 

1. “2*002 

“EV 

13 

PhOTCCUR»ENT 

2.13-305 

2.1C”«C5 

a /-•«; 

l* 

SURFACE  RESISTIVITY 

-i.oc*ron 

OHMS 

-9.65-0 11 

v  -  5  /  : 

15 

SPACE  01  SC  MARGE  POT»L 

VOLTS 

1.30*02“ 

VCLTS 

16 

internal  OISCharGEPOT’L 

2.30*23 1 

VOLTS 

:.50-cc» 

VCLTS 

1 T 

RAON  INOUCEOCONO'YCOEFFT 

1.3C-C13 

“HC*SJ 

1. -0-013 

-HO. -S3 

18 

RACN  INOUC£OCOnO*YPO»ER 

1 .32  *C2C 

INCNE> 

I. .2*2;; 

(NONE) 

19 

DENSITY 

1.50*033 

KG /■•! 

1.32*033 

“G/““3 

20 

2.50*231 

-1.50*CUC 

TABLE  6/6 

MATERIAL  PROPERTIES  (Continued) 


6.1-51 


“aTERIal  J:  cpai 


PPOPE*Tv  'nPuT  \»*luE  COOE  VALUE 


1 

dielectric  constant 

3  .50*000 

1  NCNE  ) 

3  •  50*0GC 

(NONE) 

2 

thickness 

1.30-233 

METERS 

1.30-232 

MESH 

3 

conductivity 

— 1 • G3*0CG 

mho/m 

-1—3*030 

"HO/M 

• 

ATONIC  NUMBER 

5. 30*030 

(NCNE) 

a .00*032 

(NCNE) 

5 

CELT A  VAX  JCOEFF 

2.10*033 

(NCNE) 

*.36*001 

(NONE) 

6 

£-“AX  >0EPTh«»-1 

1 .50-031 

KEV 

S.7H-0QI 

ANG-Oi 

T 

range 

7.1S*CC1 

ANG. 

*.29 -.101 

ANG. 

• 

Exponent  >  Range 

o. DC-031 

(NONE) 

S. 52*202 

ANG. 

9 

range  >  exponent 

3.12*032 

ANG. 

6.30-001 

(NONE) 

10 

Exponent 

1.77*000 

(NCNE) 

1.77*000 

(NONE) 

11 

TIEuO  F0«  IkEV  protons 

*.55-001 

(NONE ) 

4.SS-001 

(NONE  ) 

12 

NAX  OE/OX  FOR  PROTONS 

1 • *C*C32 

KEV 

l.*D*0C2 

KEV 

13 

photocurrent 

2 .30-035 

A/M**2 

2.oo-aos 

A/»»»2 

1* 

surface  resistivity 

-1.32*000 

OHMS 

-4.45-013 

V-S/Q 

IS 

SPACE  OISCHAPGE  pot*l 

1.30  *CC* 

VOLTS 

:.3c*oc* 

VOLTS 

16 

INTERNAL  JISChARGEPOT'L 

3.30*C33 

VOLTS 

2 .33 *00  3 

VOLTS 

IT 

PACN  INOUCEOCONO’TCOEFFT 

1.3C-013 

"HOMSS 

1.33-C.3 

MH0MS2 

19 

PAON  INOUCEOCONO •YPOvER 

;. 30*000 

(NCNE) 

1.33*302 

(NONE) 

19 

CENSITY 

1.30*003 

*6/“*3 

1 .32 *33  7 

XG/MMi 

20 

2.33*031 

“1.33* '7  33 

-aTEOIAL  4!  30l0 

PROPERTY 

Input  value 

CODE  value 

1 

OIELECTRIC  CONSTANT 

1.30*000 

(NCNE ) 

1.33*033 

(NONE) 

2 

thickness 

1.00-003 

-eteps 

1.30-002 

"ESh 

3 

conductivity 

-1 .30*003 

mhO/m 

-l.30*0UC 

MHC/M 

A 

ATOMIC  NUMBER 

7 • 9C*C31 

(NCNE) 

7.97*noi 

(NONE) 

S 

OELTA  MAX  XCOEFF 

4.60-331 

(NONE) 

2 . *3  *33C 

(NCNE) 

6 

E-MAX  >0EPTh*«-1 

S .30-03 1 

«Ev 

2—2-oe: 

ANG-C1 

7 

range 

6.4'*C01 

ANG. 

6.17-CQ1 

ANS  . 

9 

Exponent  >  range 

9.2C-C0I 

(NCNE) 

S. 25*731 

•NG. 

9 

range  >  Exponent 

5 . 3  5  *<’  J 1 

AND  . 

y. 22-331 

(  NONE  ) 

13 

Exponent 

1 . 73*C03 

(NONE ) 

1.7I*C3C 

(NCNF) 

ll 

yIElO  FQ"  Ik  Ev  PR3T0NS 

*.i J-CG1 

(NCNE ) 

*.13-731 

(NCNE  » 

12 

max  OE/OX  FOR  PROTONS 

1.35*032 

*E  v 

1.35*032 

*tv 

13 

PHOTO CUR PE NT 

2.9G-C35 

A/“»*; 

2. ’7-035 

A/M«»2 

l* 

surface  resistivity 

-i.oc*o;c 

OHMS 

-6.65-C17 

V-S/C 

IS 

SPACE  DISCHARGE  »ot»l 

1 •  wG  *rt3  * 

VOLTS 

2 . w  7  —  7  w  * 

VOLTS 

16 

internal  u ISCHA rSEPOT *l 

;.3r*033 

VOLTS 

:.:2*oc: 

VOLTS 

IT 

PACN  INOUCEOCONg’TCOEFFT 

1.30-313 

MHCMS3 

1.27-01? 

mhO“S2 

18 

-AON  INOL'CEOCONO ’YPO.EP 

1  .32  *'D3C 

(NCNE ) 

1.33*0uC 

( NONE ) 

19 

DENSITY 

i.gc*oo: 

»g/m«: 

1 .3C  *03  3 

KG/-*! 

20 

2.30*031 

—  1 .  w  D  *C«.0 

TABLE  6/6 

MATERIAL  PROPERTIES  (Continued) 


-ATSRIAL  is  I*i03 


PROPERTY 

INPUT  VALUE 

CODE  VALUE 

1 

DIELECTRIC  CONSTANT 

1.02*033 

(NONE  1 

1.33-C'OC 

1  NONE  1 

2 

thickness 

1.00-3C3 

PETERS 

l.jr-302 

»£S« 

3 

CONDUCTIVITY 

-1.30*003 

phO/p 

-1.33*300 

-HO/- 

4 

•TOPIC  MUP8ER 

2.44-331 

INCnEI 

2.44-3CJ 

1  NONE  1 

5 

DELTA  -AX  >COEFF 

1 .43-000 

(NONE  I 

3.02-3CC 

INCNEI 

6 

E--AX  jOEPTH— -1 

i.OC-COl 

*Ev 

1.-9 -CO 2 

ANG-Ci 

T 

Range 

-i.OO-OOD 

ANG. 

1.57*332 

»N6. 

a 

EXPONENT  >  RANGE 

.00 

I  NONE  > 

.  02 

ANG. 

9 

PANGE  >  EXPONENT 

7.18-CCC 

ANG. 

2.J1-C30 

InonCI 

13 

EXPONENT 

5.55-0C1 

INCNEI 

1.03*300 

1  NONE  1 

11 

Y»ELO  FOR  UEV  PROTONS 

4.95-031 

INQNE ) 

4.93-C31 

1  NONE  1 

12 

-AX  DE/OX  FOR  PROTONS 

..23-002 

KEV 

1.23-302 

KEV 

13 

PNO  fOCURREA  r 

1. 23-005 

A/P—2 

3. 20-305 

A/P —2 

1« 

SURFACE  RESISTIVITY 

-l.OO-COC 

OhPS 

-».85--:: 

v-S/5 

15 

SPACE  oiscnarge  pot«l 

1 .00 -004 

VOLTS 

1.20*004 

VOLTS 

16 

INTERNAL  0 ISCMAR6EP0T *L 

2. JC-003 

VOLTS 

2.30-003 

VOLTS 

IT 

RAON  INOUCEOCONO’ YCOEFFT 

t. oo-ci; 

PHCHSJ 

1. 30-013 

•N0PS3 

18 

RAON  INOUCEOCONO* YP OVER 

1. 00-000 

INCNEI 

1.C3-000 

1  NONE  1 

19 

oensity 

l.an-acs 

K6/PV3 

1.23*003 

KG/P-1 

20 

2.00*001 

-l.uO-003 

-ATERlAL  is  «AGN 


PROPERTY 

1  DIELECTRIC  CONSTANT 

2  THICKNESS 

3  CONDUCTIVITY 

4  ATOPIC  NUPStR 

5  OELtA  PAX  >C0 err 

6  e-pax  >ocpth— : 

7  RANGE 

a  exponent  >  r«ngE 

9  RANGE  >  EXPONENT 

10  EXPONENT 

U  »ielo  for  ikEv  protons 

12  **A X  DE/OX  TOR  PROTONS 

11  photocurrent 

in  surface  =esistu:ty 

15  SPACE  discharge  POT'L 

16  INTERNAL  OISCHApGEPOT’L 

IT  ® A CN  INDUCE3C3NC*tCCEFFT 

18  PAON  I  NO L'C ED C3N0*tP04£R 

19  DENSITY 

20 


INPUT  VALUE  CODE  VALUE 


1.3C-C33 

1  NONE l 

1.02»53C 

INONEI 

1.DC-C33 

PCTtPS 

1.03-502 

-ESh 

— 1 . 00*020 

-HC/N 

—  1 .00  *2 00 

-HO/P 

l. 23*331 

INOnEI 

1.22*521 

1  NONE  1 

9 .25-321 

INCNEI 

T.02 •CUC 

INONEI 

2.52-531 

k£v 

2. T9 -302 

ANG-31 

-l. 30*030 

•  NG. 

6.96*302 

ANG. 

.30 

INONEI 

.00 

ANG. 

1.74*000 

•  NG. 

1.75*300 

INCNEI 

2.43*331 

INCNEI 

1.00*003 

INONCI 

2. 44-COl 

INCNEI 

2.44-Oai 

INONEI 

2.33*022 

KEV 

2.30*032 

KEV 

•.33-505 

»/«— 2 

* .05-035 

A/P—2 

-1.00332 

Cmps 

-6.AS-C1 ' 

v-s/c 

* .»3*C.4 

VCLTS 

i .02  *C0* 

VOLTS 

2.33*033 

VOLTS 

:.oo*cc: 

VOLTS 

1 .33-313 

PHCPS3 

1.05-513 

-HOPSJ 

1.03*203 

INCNEI 

1.00*532 

INONEI 

1.03*303 

KG/  — 3 

1.02*003 

*u/P*i 

2.05*001 

-i.03*5CC 

„V 


TABLE  6/6 

MATERIAL  PROPERTIES  (Continued) 


-aTERIAL  7:  scrc 

PROPERTY 

1  DIELECTRIC  constant 

2  thickness 

j  conductivity 

•  flTOHIC  NUP8ER 

5  DELTA  -A*  >COEFF 

6  E--AX  >OEPTh— 1 

T  RANGE 

8  EXPONENT  >  RANGE 

9  RANGE  >  EXPONENT 

10  Exponent 

ti  yield  for  ik ev  protons 

12  MAX  3E/0X  FOR  PROTONS 

13  PhOTOCURRENT 

1*  SURFACE  RESISTIVITY 

15  SPACE  OtSCHARSE  POT'L 

16  INTERNAL  0 ISCHA9GEP0T *l 

17  RACN  INOUCEOCONO  * YCOEFFT 

10  RAON  INOUCEOCONO 'VPOwER 

19  DENSITY 

20 

paterial  as  kapt 

property 

1  OXELECTRIC  CONSTANT 

2  THICKNESS 

3  CONDUCTIVITY 

•  ATONIC  NUNBER 

5  OELTA  -AX  >coeff 

6  E-PAX  )OEPTh— -1 

7  RANGE 

a  exponent  >  Range 

9  RANGE  >  EXPONENT 

10  EXPONENT 

11  VIELO  For  ik  Ev  protons 

12  -AX  DE/OX  for  PROTONS 

13  PHOTOCURRENT 

i*  surface  resistivity 

15  SPACE  0ISC-ARGE  POT’L 

16  INTERNAL  OISCHARGEPOT'L 

IT  RAON  INOUCEOCONO’ YCOEFFT 

IB  RAON  INOUCSOCONO’yPOkER 

19  OENSITY 

20 


INPUT  VALUE 
1.50*022  (NONE  S 

:.cc-cc I  -ete»s 
-1.50*033  -ho/p 
1.52*933  inches 
.50  incnEs 
i.:c*oso  kev 
i.uO*cct  and* 

l.S3*C3C  INCNEI 
•CO  anG. 
l.CO*GOO  (NONES 
•or  (nones 
1. 30*033  *E  v 
.50  A/-—* 

-1.30*032  OhPS 
1.30*03*  VOLTS 
2.00*033  VOLTS 
1.02-C1J  -HOPS J 
1.3C*C30  (NONES 
1.3C*0C3  kg/h*3 
2.50*031 


INPUT  VALUE 
3.52*000  (NONE ) 
1.2T-C3R  -ETERS 
1. 02-016  pho/m 
5. 32*030  (NOnES 
2.10*030  INCNES 
I.SC-C31  kev 
T. 15*231  anG. 
r.22-231  (NCNEl 
3.12*032  ANG. 

1. T’.rao  inches 

6.53-201  (NONES 
:.»2*?32  *£v 

2. J3-C35  */— 2 
1.30*016  OhpS 
1.50*036  VOLTS 
2.32*033  VOLTS 
1.3C-013  P-0HS3 
1 .33*223  INCNES 
1.30*033  kg/  — 1 
2. 3C*?G1 


2C3E  value 
1. .2*052  INCNES 
i.;.">-oc2  -esh 
-1.53 *222  -hO/- 
1»JC*C0?  inOnes 
•5?  INONES 

l.ia-oci  ang-.?: 
1 .53*001  *NG. 

.32  ANG. 

1.52*052  (NONES 
1.39*232  INCHES 
•39  (NONES 
1.52*C5C  KEV 
.20  A/-—5 

-9.85-013  V-S/O 
1.50*20*  VOLTS 
2.30*003  VOLTS 
1.30-313  -H0HS3 
1.30G5C  INCNES 
1.39*231  KG/— I 
-l.29*CC0 


COOE  VALUE 
3.S0*C30  INONES 
1.27-90?  -ESh 

1.20- C16  -hO/p 
5.30*002  INONES 
6.56*951  INONES 
8.76-322  ANG-C1 
6.29*021  ANG. 
5.52*932  ax5. 
6.0C-1CI  INONES 
1.77*300  INONES 
6.35-051  (NONE) 
1.63*002  KCV 

2.5n-oo«  A/  —  *2 
8.85*933  V-S/C 
1.33*23*  VOLTS 
2.30*00?  VCLTS 
1.05-31?  pnCpSj 
1.30*252  INONES 
1.30*02?  KG/P*I 

1.20— 216 


rj  h  a'0»*4»w«UNHO 


TA8LE  6/6 

MATERIAL  PROPERTIES  (Continued) 


material  9:  np*i 


PROPERTY 

OIELSCTRIC  CONSTANT 
thickness 

CONDUCTIVITY 
ATONIC  NUN BE® 

OELTA  MA  X  >CO£FF 
E-**AX  >0£PTh»p-1 

PANGE 

EXPONENT  >  RANGE 

PANGE  >  EXPONENT 
EXPONENT 

YIELD  FOP  1a£v  PPOTONS 
«*ax  oe/ox  pop  protons 
PMOTOCUPRCNT 

surface  resistivity 
SPACE  DISCHARGE  pot-l 
internal  OISChARGEPOT’L 
RaON  INOUCECCONO*YCOEFFT 
RAON  I NOUCEOCONO* TPO*£R 
OENSITY 


material  13:  sio: 


INPUT  VALUE 
3.5C*CC3  INONEI 
*.CC-CJ5  -ETERS 
5.9C-3L9  **MO/" 
S.OO-CJC  (NCNEI 
I . 13*330  (NCNEI 
1. SC-031  *Ev 
-l.JC*C3C  anG. 

. :r  incne) 
WOS*CCC  ang. 

9 .40*030  INONEI 
9.SS-C01  INCNE  I 

1. *?.PC2  x£v 
2.00-035  A/***2 
i. 13*013  Ohms 
i.SC*C39  VOLTS 

2.  J3*0Q!  VOLTS 
1.30-013  -H0MS3 
1 .30*000  INONEI 
1.30*033  KG/m* j 

o.:o*oct 


COSE  VALUE 
3.50»C"C  INONEI 
S.3C-C3#  *£Sh 
S..C-C19  i‘HO/1 
S .33*030  INCNEI 
3.CS-CC1  INONEI 
3. 41-302  ANG— Cl 
1.3S»C33  ANG. 

.CO  ANG. 

l.Sl»COC  INONEI 
1.30*030  INCNEI 
9.55-001  INONEI 

1 . *C  *002  *EV 

2.  CO-OSS  A/»«*2 
s.a5*-3C  v- s/c 
1.33*039  VOLTS 
2.03*033  VOLTS 

0-013  NMONSi 
1.32*000  INONEI 
1.32*033  kS/h»3 
S.9C-01* 


PROPERTY 

DIELECTRIC  CONSTANT 

thickness 

CONDUCTIVITY 

ATONIC  number 

OELTA  MAX  >CQEFF 
E-«AX  >0EPTh»r-1 

RANGE 

EXPONENT  >  RANGE 

RANGE  >  EXPONENT 
0  EXPONENT 

1  YIELO  FOP  1KEV  PROTONS 

2  N*X  OE/DX  FQR  PROTONS 

3  PHOTOCURPENT 

9  SURFACE  RESISTIVITY 

S  SPACE  OISCHAPGE  POT*L 

b  INTERNAL  OISCHARGEPOT'L 

T  RAON  INOUCCOCGNG ’YC3EFFT 

S  PA  C N  INOUCEDCONO  * YP09L® 

9  DENSITY 


Input  value  cooe  value 

* . ;0»C20  INONEI  9.30*020  INONEI 

1.27-039  PETERS  1.2T-0U3  -ESh 

1 • CC-C19  PHC/M  1.C0-C19  -NO/** 

1.30*001  INONEI  1.30*031  INONEI 

2.90*030  INONEI  1.96*301  INONEI 

9.30- 001  NEV  2.21-032  anG-01 

1 .16*002  ANG.  9.92*001  ANG. 

a. 13-031  INCNEI  3.9 1  *CC2  ANG. 

i.a3*002  ang.  a. io-3ol  inonei 

1.86*030  INONEI  l.«6*0C£  INONEI 

* .55-C31  INONEI  9.SS-CC1  INONEI 

1 .*S*002  k£V  1.93*032  k£v 

2.30- COS  Af«»»2  2.30-335  A/«p«2 

1.3C*C19  OpPS  8.«S-036  V-S/C 

l . CC *039  VOLTS  1.JC»3C*  VOLTS 

2.20-CC3  VOLTS  2.33*033  VOLTS 

I.GC-OII  PhOPSI  1.23-01!  *hO"SS 

:.3C*C3C  INCNEI  l.S0*00C  INCNEI 

l.a0*3CI  AG/""!  I.C0*CC3  kG/mpJ 

2.00*031  1. 03-019 


Q«» 
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MATERIAL  PROPERTIES  (Continued) 
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Us  sola 

PROPERTY 

dielectric  CONSTANT 
thickness 

CONDUCTIVITY 
ATOPIC  NUH8EP 
OELTA  “AX  >CO£FF 
E-HAX  >0£PTmp*-1 

RANGE 

EXPONENT  >  0 ANGE 

RANGE  >  EXPONENT 
EXPONENT 

YIElC  POP  IKEV  PROTONS 
"Ax  OE/OX  POP  PROTONS 
PHOTOCUP PENT 
SuPPACE  RESISTIVITY 
SPACE  CISCHAP3E  POT*L 
INTERNAL  OISCHAPSEPOT'L 
PA  ON  INOuCEOCO.NO'rCJEFPT 
PAON  INOUCEOCONO*YPO.£B 
DENSITY 


NATEPIAL  12S  TEPL 
PROPERTY 

1  OIElEcTRIc  constant 

2  THICKNESS 

3  CONDUCTIVITY 

«  ATONIC  NUNflCR 

5  DELTA  HAX  >COEFP 

6  E-“AX  >OCPTh*«-1 

7  RANGE 

a  EXPONENT  >  RANGE 

9  RAn6E  >  EXPONENT 

0  EXPONENT 

1  YIELD  POP  IKEV  protons 

2  rax  oe/ox  pop  protons 

3  PHOTOCuPRENT 

N  SURFACE  RESISTIVITY 

5  SPACE  DISCHARGE  POT*L 

6  INTERNAL  OISCHAPGEPOT*L 

7  RACN  INOUCEOCONO* YC9EPPT 

a  RAON  I  NOUCEuCSNO’ YPOttEP 

9  DENSITY 


INPUT  VALUE 

CODE  VALUE 

i.ac*oeo 

INONE) 

3.aa*505 

INONE) 

1.7R-C39 

"ETERS 

1.79-533 

-ESrt 

i.cc-cit 

“M0/“ 

I. DO-017 

hhO/k 

i.do-pci 

(NONE  1 

1.33*001 

INONE ) 

2.35*035 

INONE) 

1.21*001 

1  NONE  > 

9.1C-C3I 

K£V 

3.17-532 

ANG-31 

7 . 7! *00 I 

ANG. 

3.  **9*00! 

ANG  • 

*.50-001 

INCNEl 

2.75*032 

ANG. 

1 .56*032 

ANG. 

*.83-501 

INONE) 

I .73*230 

•NONE) 

1.73*035 

INONE) 

£.**-CGI 

INONE) 

2.**-?Ct 

1  NONE) 

2.25*032 

MEV 

2.30*332 

«ev 

2. do-cos 

A /“••£ 

2.32-0CS 

a/h**; 

;.oc*c;9 

OH“S 

S. 45*326 

v-s/: 

1.30*55* 

VOLTS 

l.D2*C0* 

VOLTS 

:.:c*oc3 

VOLTS 

2  .  „3*3C 3 

VOLTS 

i.dc-ci3 

“M0MS3 

i.DC-Cl! 

“hC“S3 

l.DC*CDD 

INONE ) 

1.02*323 

INCNE ) 

1.3C-C32 

kG/n* J 

i.u3*5QT 

kG/-*5 

I .25*531 

1.02-017 

INPUT  VALUE 

CCCE  value 

Z . 23*C59 

INCNE) 

2.D3*02C 

INCNE 1 

1. 27-039 

peters 

1.27-333 

PESrt 

l.GC-016 

“HO/P 

l. 30-016 

“MO  /  * 

r.oa*aaa 

(NONE) 

7.30*000 

IN ONE) 

3.33*030 

INONE) 

2.27*001 

INONE ) 

3.3C-00I 

K  CV 

S.i 3-OC2 

ANG— **1 

*.S**OCI 

ANG. 

1.3 1 *C31 

ANG. 

4.30-501 

INCNE) 

3.65*002 

ANG. 

2.18*032 

ANG. 

9.30-301 

INONE) 

1. T7*030 

INONE) 

1.77*D0C 

INONE) 

R.SS-001 

INONE) 

*.55-031 

INONE) 

1 .90*032 

KCV 

1.  *2*002 

KEV 

2.30-035 

A/“«*2 

2.30-005 

A/P“*2 

1.30*016 

OHPS 

8.85*033 

V-S/O 

1.35*039 

VOLTS 

l. DC»CO» 

VOLTS 

2  »3C*C33 

VOLTS 

2.30*033 

VOLTS 

1.DC-C13 

PMOHS  3 

UJ2-C13 

“H0HS3 

i.2C»C30 

INONE ) 

:.D3*:cc 

INCNE ) 

1 «  30*333 

KG/“»3 

1.30*033 

KG/“*3 

2.35*001 

1.DC-C16 

O 


TABLE  6/6 

MATERIAL  PROPERTIES  (Concluded) 


MATERIAL  13:  SILV 
PROPERTY 

oielectr:c  constant 
thickness 

CONDUCTIVITY 
ATONIC  N UNSET 
DELTA  «*AX  >CoEFF 
E-MAX  >OEPTh*«-1 

PANGC 

EXPONENT  >  TANGE 

pange  >  Exponent 

EXPONENT 

VIElD  fop  ikEv  ppotons 

NAX  OE/O*  FOP  PROTONS 
PHCTOCuPPCNT 

surface  resistivity 
SPACE  OI SC MARGE  POT'L 
INTERNAL  DISCHARGE Pot *L 
RACN  lNOUCEuCONO*VCOEFFT 
RAOT.  iNOUCEDCONO'TPOdER 
CENSIT » 


INPUT  VALUE  CODE  VALUE 

i.32*0CC  (NONE)  1.03*009  (NONE > 

1.0C-003  METERS  1.00-003  m£Sm 

-1.00*000  "HO/h  -1.00*030  »mO/n 

*.70*001  INCNE)  *. 73*301  (NONE! 

1.00*000  (NONE)  3.09*009  (NONE) 

8. 30-001  *EV  1.58-002  ANG-31 

8. *5*001  ANG.  6.93*001  ANG. 

9.20-001  (NONE)  1.36*002  ANG. 

7.9**3iil  ANG.  8.23-CCl  (NONE) 

1 . 7**C0C  (NONE)  1.7**C30  (NONE) 

* .9C-CC1  (NCNE)  *.90-001  (NONE) 

1.23*302  KEv  1.23-CC2  »£V 

2. 90-035  A/**«2  E.90-ftC5  a/“p*2 

-1.3C*00C  OHMS  -8.8S-01I  v-S/C 

1.30*00*  VOLTS  1.33*00*  VOLTS 

2.33*00!  VOLTS  3.33*003  VOLTS 

1.0C-C13  hhonso  1.32-01!  hhOhsi 

1.30*003  (NONE)  1.23-9CC  (NONE) 

l.39*SC!  kg/h«S  1. •30*93!  *&/«•! 

2.00*921  -l.J“*0C0 


V  v 


6.1-57 

If  a  material  called  'GOLD'  or  'GOLDPD'  or  'GOLDXXXX'  is  defined  later 
with  different  properties  the  number  of  materials  POLAR  thinks  it  has 
will  be  increased  by  one,  but  the  new  properties  will  be  effectively 
ignored.  Multiple  definition  of  materials  should  be  avoided.  Note, 
however,  that  if  any  of  the  default  materials  are  explicitly  defined 
before  they  are  referred  to  in  building  block  definitions  then  POLAR 
will  make  no  attempt  to  find  them  in  the  list  of  default  materials  ana 
the  materials  will  not  be  multiple  defined. 

6.13  THE  OBJECT  DEFINITION  FILE  -  ANOTHER  EXAMPLE 

Vie  are  now  ready  to  bring  together  Sections  6.10-6.12  and 
examine  the  structure  of  the  object  definition  file.  The  general  form 
is  shown  in  Figure  6/17.  The  materials  are  defined  first,  followea  by 
the  building  blocks  associated  with  each  separate  conductor.  The  use 
of  COMMENT  cards  allow  the  logic  of  the  definition  of  a  complex  object 
to  be  followed  more  easily.  Finally  the  whole  file  is  terminated  with 
an  'ENOSAT'  statement.  An  actual  example  is  shown  in  Figure  6/18.  It 
consists  of  a  central  RECTANgular  body  connected  to  two  QSPHERES  at 
the  ends. 

A  30-VIEW  (6.20)  of  the  object  produced  by  VEHICL  is  shown  in 
Figure  6/19. 
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6. 


I (COMMENT  WORKED  EXAMPLE  (SECTION  6.13> 

2 i COMMENT  MATERIAL  DEFINITIONS 

3(C0NNENT  FOR  PRESENT  PURPOSES.  ALL  PROPERTIES  ARE  'KAPTON 

4 « CONNENT  EXCEPT  THICKER 

SiTKAP 

6i  3.S..»1.1.E-16.S.,2.1,.1S171.4S..6*. 

7 j  312. 1,1 .77,  .455. 140. ,  .MM2. 1  .E+lfi.  1  .EM.2.EO, 

8i  1.E-13.1..1.E+3.20. 

9« CONNENT  USE  DEFAULT  KAPTON  AND  COLD  UALUES 
10 < CONNENT  DEFINE  THE  MAIN  BODV  AND  TOP  SPHERE  TO  IE  ON 
11 (CONDUCTOR  1 
12IC0NNENT  RAIN  CUIOID  IODV 
13IRECTAN 
14 l CORNER  -I  -1  -2 
15 1  DELTAS  3  3  4 
lfiiSURFACE  *X  GOLD 
1 7 l SURFACE  -X  KAPTON 
II l SURFACE  -V  KAPTON 
19 I SURFACE  «V  KAPTON 
20i SURFACE  -Z  KAPTON 
21 i SURFACE  *Z  TKAP 
22IEN00DJ 

23 i CONNENT  TKAP  SPHERE  ON  TOP 

24<0SPHERE 

25 i CENTER  R  •  3 

2S i DIAMETER  3 

27ISIDE  1 

21 l MATERIAL  TKAP 

29IEND0U 

30 > CONNENT  PUT  THE  DOTTON  SPHERE  ON  CONDUCTOR  2 
31 t CONDUCTOR  2 
32I0SPHERE 
33 1  CENTER  •  0  -4 
34 i DIAMETER  3 
35 1  SIDE  1 
36 (MATERIAL  GOLD 
37IEND0IJ 
3S I ENDS AT 
EOF  ( 31 
SO 


Figure  6/18.  Object  definition  file 


6.14  OBJECTS  WITHIN  OBJECTS:  VARIEGATED  SURFACES 

POLAR  makes  it  easy  to  define  surfaces  that  are  made  up  of  more 
than  one  material.  For  example,  we  may  want  to  define  one  face  of  a 
cube  to  be  mainly  KAPTON  but  with  a  patch  of  say  GOLD  in  the  center 
(Figure  6/20).  We  begin  by  defining  the  cube  with  a  KAPTON  face.  The 
center  surface  cell  is  then  replaced  with  GOLD  by  defining  a  second 
smaller  cube  inside  the  first  cube.  The  second  cube  is  defined  so 
that  one  of  its  faces  is  coincident  with  the  KAPTON  face.  The  surface 
common  to  both  cubes  is  then  associated  with  the  material  on  the  face 
of  the  second  cube,  which  in  this  case  is  GOLD.  This  is  shown  in 
Figure  6/20. 

The  object  definition  file  associated  with  this  object  has  the 

form: 


COMMENT 

VARIEGATED  CUBE 

RECTAN 

CORNER 

-2 

C\J 

1 

eg 

1 

DELTAS 

3 

3  3 

SURFACE 

+x 

KAPTON 

SURFACE 

-X 

KAPTON 

SURFACE 

+y 

KAPTON 

SURFACE 

-y 

KAPTON 

SURFACE 

+z 

KAPTON 

SURFACE 

-z 

KAPTON 

ENDOBJ 

RECTAN 

-l 

-1  -1 

CORNER 

DELTA 

l 

1  1 

SURFACE 

-z 

GOLD 

ENDOBJ 

ENDSAT 

The  same  principle  can  be  applied  to  any  of  the  building 
blocks.  Exposed  surface  cells  common  to  two  or  more  building  blocks 
are  assigned  to  the  material  of  the  most  recently  defined  block. 

Two  special  building  blocks  are  supplied  specifically  to  create 
variegated  surfaces.  PATCHR  and  PATCHW  define  a  RECTAN  (cuboid)  and  a 
WEDGE  respectively,  that  may  be  used  to  "patch"  other  objects  without 
adding  to  POLAR's  list  of  filled  space.  The  use  of  actual  RECTAN  and 
WEDGE  blocks  inside  others  is  also  perfectly  legitimate,  but  adds  to 
the  internally  used  surface  list.  The  use  of  PATCHR  and  PATCHW 
reduces  the  likelihood  of  a  problem  occurring  due  to  the  list 
overflowing. 

The  object  shown  in  Figure  6/20  could  also  be  defined  using 
PATCHR: 


COMMENT 

VARIEGATED  CUBE  (PATCHR) 

RECTAN 

CORNER 

-2 

1 

f\> 

1 

ro 

DELTAS 

3 

3  3 

SURFACE 

+X 

KAPTON 

SURFACE 

-X 

KAPTON 

SURFACE 

+Y 

KAPTON 

SURFACE 

-Y 

KAPTON 

SURFACE 

+Z 

KAPTON 

SURFACE 

-Z 

KAPTON 

ENDOBJ 

PATCHR 

CORNER 

-1 

-1  -1 

DELTAS 

1 

1  1 

SURFACE 

-Z 

GOLD 

6.20  VEHICL 


The  VEHICL  module  is  used  to  interpret  the  object  definition 
file  (Section  6.10)  in  order  to  create  the  various  tables  and  lists 
necessary  for  the  other  modules  (Sections  5.23-5.25).  It  also  can 
produce  two  separate  kinds  of  object  plots.  By  using  appropriate 
keywords,  either  material  or  perspective  plots  are  produced  after  the 
object  file  passes  through  the  initial  definition  processing. 

When  using  keyword  inputs,  each  line  (or  card)  is  expected  to 
contain  one  keyword  followed  by  its  list  of  parameters.  After  the 
keyword  and  parameters  have  been  completely  defined,  the  rest  of  the 
line  is  ignored.  Several  characters  are  ignored  by  the  input 
routines,  namely  extra  blanks  between  words  (though  some  type  of 
delimeter  is  necessary),  equal  signs  («),  and  commas  (,).  All  input 
is  read  using  free  formatting  with  lower  case  characters  being 
converted  to  upper  case,  and  real  numbers  may  be  entered  as  integers. 

VEHICL  will  need  the  following  permanent  files:  2.  (for 
graphics  output),  11.  (KSIO),  19.  (MSIO),  and  20.  (the  object 
definition  file,  used  as  input).  The  following  temporary  scratch 
files  will  also  be  required:  3.,  14.,  17.,  18.,  21.,  and  27..  All  of 
these  files  should  be  assigned  with  large  storage  limits. 

6.21  VEHICL  KEYWORDS 

The  specialized  VEHICL  keywords  fall  into  three  general 
categories;  object  definition,  graphical  output,  and  diagnostic  output 
control.  (See  Table  6.21/1  for  a  brief  summary  of  the  keywords.)  The 
diagnostic  keywords  are  described  in  detail  in  Section  6.22. 
Additionally,  all  of  the  general  POLAR  keywords  (Section  6.70),  except 
SELECT,  are  recognized  by  the  input  routines.  SELECT  cannot  be  used 
by  VEHICL  because  the  grid  information  needed  by  the  subroutine,  NRBUF 
(5.30),  is  not  necessarily  well  defined. 


6.2-2 

If  an  unrecognized  keyword  or  an  invalid  use  of  a  keyword  is 
discovered,  VEHICL  issues  a  warning  or  an  error  message  then 
terminates  batch  runs  or  reads  the  next  input  in  the  case  of 
interactive  runs.  By  default,  VEHICL  believes  it  is  being  rur 
interactively.  The  keyword  BATCH  (see  Section  6.70)  will  place  VEHICL 
in  its  batch  input  mode. 

The  recognized  keywords  which  control  the  object  and  grid 
definition  are: 

NXYZ 

NXYZ  defines  the  size  of  the  object  grid.  This  keyword 
absolutely  must  be  defined  for  each  execution  of  VEHICL  since  there 
are  no  default  values  for  grid  dimensions.  The  run  will 
unconditionally  abort  in  the  absence  of  this  keyword.  An  example  of 
the  use  of  the  keyword  is 

NXYZ  678 

This  defines  an  object  grid  which  has  six  nodes  in  the  X-direction, 
seven  nodes  along  the  Y  axis,  and  eight  on  the  Z  edge  of  the  grid. 

Note  that  these  numbers  are  in  nodes,  not  elements.  So  a  1  x  1  x  1 
cube  would  require  a  grid  of  at  least  4x4x4  since  object  itself  is 
2x2x2  nodes  and  none  of  the  object's  vertices  are  allowed  to  touch 
the  grid  boundary.  In  general,  extra  space  around  the  object  is  a 
good  idea,  especially  if  the  object  is  centered  asymmetrically  in  the 
grid  and  the  object  may  be  reoriented  within  the  object  grid  later 
using  ORIENT  (6.30).  These  problems  can  also  be  avoided  if  an  odd 
number  of  nodes  along  each  axis  are  used.  For  more  information 
concerning  the  declaration  of  object  grid  size,  please  see  Section 
6.10. 

DXMESH 

DXMESH  defines  grid  size  in  meters.  For  example, 

DXMESH  »2.0 

would  define  a  grid  spacing  of  two  meters,  while 

DXMESH  .01 


sets  the  spacing  to  one  centimeter.  The  default  value  is  one  meter. 
This  size  may  be  easily  changed  later  during  NTERAK. 

PREFIX 

PREFIX  is  used  to  declare  the  object  file  name  for  the  UNIVAC 
version  of  POLAR.  The  CYBER  version  expects  the  object  definition  to 
be  located  in  file  2Q,  so  the  PREFIX  keyword  is  not  needed. 

In  the  UNIVAC  version,  VEHICL  must  know  the  file's  name  in  order 
to  be  able  to  find  the  input.  If  this  keyword  is  omitted  in  the 
UNIVAC  version,  VEHICL  will  terminate  with  an  error  message.  As  an 
example, 

PREFIX  MICRO 

causes  VEHICL  to  read  from  the  file  KICROOBJ.  Note  the  suffix  OBJ 
must  be  used  in  all  object  file  names.  There  is  no  default  value  for 
this  keyword. 

GRAPHICAL  OUTPUT  CONTROL  KEYWORDS 

MATPLOTS 

The  keyword  MiATPLOTS  controls  the  plotting  of  material  plots. 
Material  plots  consist  of  six  views  of  the  object  from  each  direction 
of  all  three  axes.  The  surfaces  of  the  satellite  are  filled  in  with 
different  patterns  depending  on  their  material  type.  It  should  be 
noted  only  VEHICL  can  produce  material  plots,  SHONTL  is  not  able  to 
duplicate  them,  although  it  can  draw  the  same  views  without  surface 
material  patterns. 

To  control  this  feature,  use 
MATPLOTS  YES 
to  turn  it  on  and 
MATPLOTS  NO 

to  turn  it  off.  By  default,  no  material  plots  will  be  created. 
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The  graphical  output  created  by  VEHICL  is  written  on  file  2,  and 
needs  to  be  interpreted  by  the  post-processor  graphics  package  (see 
Section  6.6).  On  the  UNIVAC,  this  can  be  done  automatically  by  using 
the  PLOTDEST  keyword  described  below. 

MAKEPLOT 

MAKEPLOT  controls  the  creation  of  perspective  plots. 

Perspective  plots  are  views  of  the  object  as  seen  from  infinity  along 
a  user  defined  vector.  Both  hidden  line  and  transparent  object 
drawings  are  produced.  These  views  only  can  be  drawn  by  VEHICL; 

SHONTL  is  not  able  to  generate  them. 

The  keyword  MAKEPLOT  tells  VEHICL  how  many  views  to  expect.  The 
actual  viewing  directions  are  defined  using  the  PLOTDIR  keyword 
described  below.  To  set  the  number  of  views,  use 
MAKEPLOT  N 

where  N  is  an  integer  from  0  to  8.  A  default  set  of  views  (along  each 
direction  of  all  three  axes)  can  be  requested  using 
MAKEPLOT  OEFAULT 
or  just 

MAKEPLOT 

In  both  cases,  PLOTDIR  does  not  need  to  be  used  to  aefine  the  views. 

If  no  perspective  plots  are  desired, 

MAKEPLOT  0 

will  disable  this  feature.  VEHICL  by  default  will  not  make 
perspective  plots. 

The  graphical  output  created  by  this  command  will  be  saved  on 
file  2  and  can  be  interpreted  by  the  graphics  post-processor  described 
in  Section  6.6.  On  the  UNIVAC  this  may  be  done  automatically  by  using 
the  PLOTDEST  command  described  below. 


PLOTOIR 


PLOTDIR  is  used  to  define  viewing  vectors  for  perspective 
plots.  Each  use  of  PLOTOIR  describes  one  of  the  views  from  infinity 
requested  by  the  MAKEPLOT  keyword  described  above.  To  actually 
produce  a  plot,  MAKEPLOT  must  be  used.  An  example  of  the  use  of 
PLOTDIR  is 

PLOTDIR  -2.  +1.5  -1. 

/V  A  A. 

would  be  a  view  along  —2 .Oi  +  1 . 5 j  -  1.0k  from  infinity.  Default 
directions  can  be  defined  with  the  MAKEPl  OT  keyword. 

PLOTDEST 

The  keyword  PLOTDEST  is  used  to  draw  the  plots  created  using  the 
MATPLOTS  or  MAKEPLOT  keywords  described  above  immediately  after  VEHICL 
completes  its  execution.  The  keyword  is  only  functional  in  the  UNIVAC 
version  of  POLAR.  Of  course,  it  is  always  possible  to  draw  the  plots 
using  the  graphics  post-processor  (Section  6.6). 

In  the  S-CUBED  UNIVAC  version  of  POLAR,  several  plotting  devices 
are  available.  They  are  the  electrostatic  plotter,  the  Calcomp  and 
the  Tektronix  4014.  To  automatically  draw  plots  on  the  later  device, 
one  must  run  VEHICL  from  the  Tektronix  where  the  plots  are  desired. 

The  general  form  of  the  PLOTDEST  command  is 
PLOTDEST  destination 

where  destination  can  be  blank,  NONE,  CALC  (for  Calcomp),  ELEC  (for 
electrostataic)  and  TEKT  (for  Tektronix  4014).  Leaving  the 
destination  blank  or  using  NONE  results  in  no  plots  being  drawn  at  the 
conclusion  of  VEHICL  (again  the  post-processor  still  can  be  used); 
this  is  the  default  condition. 

OTHER  VEHICL  KEYWORDS 

The  following  keywords  are  useful,  or  necessary,  when  running 
VEHICL.  They  are  also  described  in  Section  6.7. 


BATCH 


6.2-6 


This  keyword  causes  the  Input  to  be  read  In  a  batch  mode.  The 
main  effect  will  be  felt  when  erroneous  input  is  discovered.  If  this 
occurs  while  in  the  batch  mode,  VEHICL  will  abort  with  an  appropriate 
message.  The  default  input  mode  for  VEHICL  is  interactive  (see 
description  of  INTERACT  below).  An  example  is 
BATCH 

which  places  the  input  routines  in  their  batch  input  modes. 

COMMENT 

See  description  of  REMARK  below.  The  two  keywords  are 
equivalent. 

DEFAULT 

DEFAULT  sets  the  VEHICL  default  values.  In  general,  the 
defaults  are  for  no  diagnostic  output,  no  plots,  a  grid  spacing  of 
1  meter,  and  an  interactive  input  mode.  The  keyword  DEFAULTS  is 
equivalent  to  DEFAULT.  An  example  is 
DEFAULT 

VEHICL  automatically  calls  the  default  routine  before  soliciting 
input.  This  keyword  is  most  usedful  when  using  the  interactive  mode 
and  the  previous  input  has  not  been  satisfactory,  or  in  error. 

END 

The  keyword  END  is  used  to  signify  the  end  of  input  to  VEhICL. 
This  keyword  should  always  be  used  at  the  end  of  a  runstream,  but  if 
an  EOF  (end-of-file)  is  encountered  instead,  VEHICL  will  still 
function  normally. 


An  example  is 
END 

No  more  Input  will  be  read  at  this  point  and  VEHICL  will  begin 
operation. 

INTERACT 

The  INTERACT  keyword  is  used  to  place  the  VEHICL  input  routines 
in  an  interactive  mode.  This  means  that  any  errors  encountered  in  the 
input  runstream  will  generate  an  appropriate  error  or  warning  but  will 
not  cause  VEHICL  to  terminate  its  execution.  This  is  the  default  mode 
of  input  for  VEHICL.  To  abort  on  the  discovery  of  bad  input,  use  the 
BATCH  command  described  above.  An  example  of  the  use  of  the  keyword  is 
INTERACT 

which  will  place  VEHICL  in  an  interactive  input  mode. 

REMARK 

This  keyword  is  used  to  insert  comments  in  a  runstream.  When  a 
REMARK  is  encountered,  the  remainder  of  the  input  card  will  be  ignored 
and  a  new  card  will  be  read.  Any  number  of  REMARKS  may  be  used.  An 
example  of  the  use  of  the  REMARK  keyword  is 
REMARK  THIS  IS  A  REMARK 

All  of  the  data  on  the  card  following  the  first  REMARK  will  be 
ignored.  The  keyword  COMMENT  (mentioned  earlier)  can  be  substituted 
for  REMARK  and  is  completely  equivalent,  for  example, 

COMMENT  THIS  IS  A  REMARK  TOO. 

And  again,  everything  on  the  card  which  follows  COMMENT  will  be 
ignored. 


TABLE  6.21/1 

SUMMARY  OF  THE  VEHICL  KEYWORDS 


BATCH 

COMMENT  text 

DEFAULT 

DEFAULTS 

DXMESH  length 
END 

INTERACT 

MAKEPLOT  option 

MAKEPLOTS  option 

NXYZ  ix  iy  iz 

PREFIX  name 

PLOTDEST  option 

PLOTDIR  x  y  z 
REMARK  text 


Places  VEHICL  input  routines  in  a  batch 
input  mode.  The  default  mode  is 
interactive.  (See  INTERACT.) 

Causes  text  to  be  ignored  by  the  input 
routines.  Text  may  be  any  set  of 
characters  and  numbers. 

Resets  options  to  default  values.  Called 
automatically  at  beginning  of  VEHICL. 

Defines  grid  spacing.  Length  is  the  grid 
spacing  in  meters.  Default  is  1  meter. 

Makes  the  end  of  the  VEHICL  input. 

Should  be  included  at  the  end  of  all 
runstreams. 

Places  VEHICL  input  routines  in  their 
interactive  input  modes.  This  is  the 
default  mode.  (See  also  BATCH.) 

Controls  number  of  perspective  plots. 

Valid  options  are  DEFAULT  (produces  6 
default  viewing  directions)  or  an  integer 
from  0  to  8.  The  default  option  is  0. 

Control  material  plot  production.  Valid 
options  are  YES  and  NO.  The  default  is 
NO. 

Defines  object  grid  size,  where  ix,  iy, 
and  iz  are  integers  defining  the  number 
of  nodes  in  the  x,  y  and  z  directions, 
respectively.  This  keyword  must  be 
included  in  all  VEHICL  runstreams. 

Defines  the  file  name  containing  the 
object  definition.  If  the  file  name  is 
CUBEOBJ,  name  would  be  replaced  by  CUBE. 
(Keyword  applies  to  UNIVAC  only.) 

Controls  where  plots  are  drawn  at  end  of 
a  VEHICL  run  (UNIVAC  only).  Valid 
options  are  blanks,  NONE,  CALC,  ELEC,  and 
TEKT.  The  default  is  NONE. 

Describes  viewing  direction,  from 
infinity,  used  to  draw  a  perspective  plot. 

Causes  text  to  be  ignored  by  the  input 
routines.  Text  may  be  any  set  of 
characters  and  numbers. 


6.22  VEHICL  DIAGNOSTIC  KEYWORDS 


There  are  several  levels  of  diagnostic  output  available  from 
VEHICL  by  keyword  instructions.  None  of  it  is  of  interest  to  the 
casual  user  and  is  mainly  a  remnant  of  the  code  development  process. 
8ut  sometimes  errors,  code  modifications  or  just  idle  curiosity  will 
require  some  of  VEHICL's  diagnostic  output.  By  default,  all  VEHICL 
output  flags  will  be  turned  off  or  set  to  the  lowest  possible  values. 

The  following  is  a  description  of  the  appropriate  diagnostic 
flags  and  their  settings. 

DIAG  General  VEHICL  Output 

>0  No  output. 

■1  A  few  crucial  tidbits  from  the  construction  of 

the  A-2,  KSURF,  LCEL,  and  LTBL  lists. 

-2  More  details  concerning  the  construction  of 

the  various  lists. 

«3  Still  more  information. 

-4  Provides  a  great  amount  of  details  concerning 

VEHICL's  actions. 

IDIAGS(l)  DCVCEL  Information 

■0,  1,  2,  3  No  output. 

■4  Output  from  DCVCEL  during  the  creation  of  the 

SREL  list.  Also,  Information  from  the  various 
VCUBE  routines. 

«5  Additional  DCVCEL  data. 

IDIAGS(2)  CBUF  Data  Management 
■0,  1  Nothing. 

■2  Output  from  BUFSET. 

■3  Output  from  PAGER. 

All  of  the  Information  from  PAGER  and  GRI 010. 


>4 


JDIAGS(l) 

-0, 

.2 

>3 

-4 

JDI AGS ( 5 ) 
-0, 

■3 

*4 

JDI AGS ( 9 ) 
<4 
.4 

KDIAGS(l) 

-1 

-2 


6.2-10 

SREL  Information 

1  No  output. 

Print  out  LCEL  and  SREL  lists.  Also 
information  from  RECELL,  SREL  index  to  LCEL. 

Print  out  preliminary  LCEL  list. 

Detailed  output  from  routines  constructing 
LCEL  and  SREL  lists. 

Double  Point  Data 

1,  2  Nothing. 

Double  point  locations  from  SPDPNT. 

More  double  point  information  from  SPDPNT. 

MTLGEN  Information 

No  information. 

Material  properties  and  final  PSGM  matrix. 

MSIO  information  (UNIVAC  only) 

MSIO  routines  echo  calls  to  themselves. 

Perform  tracebacks  when  called. 


OBJPRT  level  Output  from  initial  object  definition 

routines.  Acceptable  level  keywords  are  NO, 
SOME  or  ALL. 

HIDPRT  level  Output  from  hidden  line  routine,  HIDCEL. 

Valid  level  keywords  are  YES  and  NO.  Note 
that  YES  will  generate  a  vast  amount  of  output 


IOGRID  level 


Grid  information.  Valid  level  keywords  are 
YES  and  NO.  Currently,  this  keyword  is 
deactivated. 


6. 


Some  examples  are 
D1AG  3 
I DI AGS ( 2 )  .  4 
JDIAGS(9)  3 
08JPRT  SOME 
HIDPRT  NO 

This  set  of  keywords  would  produce  a  high  level  of  general  information 
concerning  the  mechanics  of  the  object  definition  (DIAG  and  OBJPRT), 
no  MTLGEN  or  HIDCEL  data  (JDIAGS(9)  and  HIDPRT),  and  all  of  the 
available  C6UF  information  ( IDIAGS(2 ) ) . 

6.23  AN  EXAMPLE  OF  A  VEHICL  RUN 

In  Section  6.13,  an  object  was  defined  (Figure  6.1/18)  and  a  3-D 
view  of  it  was  presented  (Figure  6.1/19).  Assuming  the  object 
definition  kept  in  a  file  called  XMPLOBJ  (UNIVAC),  or  on  file  20 
(CYBER),  and  the  necessary  files  have  been  declared  large  enough 
(6.20),  Figure  6.2/1  shows  the  runstream  (UNIVAC)  used  to  draw  Figure 
6.1/19.  The  view  used  in  the  figure  was  the  second  one  defined, 
PLOTDIR  1.5  1.  .5 


ItfXOT  VEHICL 
2  HATCH 
3IHAKEPL0T  2 
4IPL0TDIR  l.S  1.  .8 
5 » PLOTDIR  l.S  1.  .5 
t. i  REMARK  PLOTDIR  3. 
7* RE HARK  PLOTDIR  3. 
8 t REMARK  PLOTDIR  2. 
9 I REHARK  PLOTDIR  2. 
lOlPLOTDEST  HONE 
1 1 I HA TP LOTS  NO 
I2IDIAC  1 
13! JDIACS( 1 )  2 
14l JDIACS<9)  4 
15 1 REMARK  IOIAOSd  )  i 
16INXVZ  18  IS  16 
17! DXHE5H  1. 

19IPREFIX  XHPL 
19IEND 
EOF i 19 
•O 


1. 

S. 

1. 

3. 


2. 

2. 

-3. 

-1. 


Figure  6.2/1.  VEHICL  runstream  used  to  draw  Figure  6.1/19. 


In  addition,  several  diagnostic  flags  were  used  which  produced 
about  2000  lines  of  unnecessary  output. 

The  grid  was  chosen  to  comfortably  hold  the  object.  If  this 
object  had  been  defined  to  be  run  later  using  NTERAK,  the  grid  would 
have  been  defined  with  more  care  with  respect  to  the  final  desired 
size.  It  Is  best  to  keep  from  defining  a  great  deal  of  extra  space  in 
the  z-direction  (or  In  the  direction  which  becomes  the  z-direction 
after  reorientation)  to  prevent  the  needless  10  of  oversized  object 
grid  size  tables  (Section  5.3). 

6.24  TROUBLESHOOTING  VEHICL 

f'^ual ly  VEHICL  will  provide  an  explanatory  error  message  before 
it  dies.  The  most  common  fatal  error  which  currently  has  no  message 
or  at  least  an  opaque,  user  hostile  message.  Is  from  DCVCEL  In 
SUREAL.  The  message,  "##### -FATAL-FROM  DCVCEL  -  ELEMENT  NUMBER  ... 

DOES  NOT  CORRESPOND  TO  LIST  ENTRY  . ",  results  from  the  grid  being 

defined  too  small  or  the  object  being  too  close  to  one  side. 

What  has  happened  is  that  somewhere  the  object  has  touched  the 
edge  of  the  object  grid.  The  cure  Is  simply  to  try  again  with  a 
larger  object  grid. 

Poorly  defined  objects  or  ambiguous  double  points  also  create 
difficult  problems.  Some  useful  advice  can  be  found  in  Section  6.11. 
If  the  definition  process  has  proceeded  far  enough.  It  may  be  possible 
to  produce  material  or  perspective  plots  as  a  visual  aide  (Sections 
6.20  and  6.21).  The  SHONTL  module  may  also  be  used  to  draw  the  object 
or  to  print  out  some  of  the  list  output  which  has  been  saved  In  the 
MSIO  files  using  CBUF  storage  functions  (5.30). 


6.30  ORIENT 


In  order  that  the  object  may  be  defined  in  an  arbitrary 
direction  or  defined  once  and  used  in  several  orientations,  it  is 
necessary  to  be  able  to  automatically  reorient  the  satellite.  The 
ORIENT  module  does  this  by  rotating  both  the  object  and  the  object 
grid.  This  is  necessary  since  NTERAK  assumes  the  largest  component  of 
flow  vector  will  be  in  the  positive  Z-direction,  forcing  a  preferred 
direction  on  the  problem.  This  module  allows  the  same  object  to  be 
studied  in  any  flowing  plasma  without  redefinition.  Of  course,  if  no 
rotation  is  necessary,  OREINT  does  not  need  to  be  used. 

ORIENT  uses  as  input  files  the  MSIO  output  files,  11  and  19, 
created  by  VEHICL.  These  files  are  also  the  output  files,  so  the> 
should  be  copied  if  the  VEHICL  output  is  to  be  preserved. 

6.31  ORIENT  KEYWORDS 

In  general,  the  keywords  which  were  accepted  by  VEHICL  (6.2',  can 
be  used  in  ORIENT  since  the  two  modules  share  many  routines.  Instead 
of  redefining  VEHICL  keywords  again,  a  reference  to  the  section 
explaining  the  command  will  be  given.  The  reader  is  also  referred  to 
the  general  keyword  input  section,  6.7,  for  more  information.  Table 
6.31/1  contains  a  brief  summary  of  ORIENT  commands  for  convenience. 

The  following  is  a  description  of  the  set  of  ORIENT  keywords. 

VMACH 

VMACH  is  the  plasma  flow  direction  normalized  to  the  ion 
acoustic  speed.  The  entire  problem  will  be  rotated  so  that  the 
largest  component  of  VMACH  will  be  in  the  positive  z-direction.  The 
rotated  VMACH  will  be  stored  and  will  be  the  default  value  for  the 
NTERAK  module.  But  the  Mach  vector  can  be  changed  later  to  any  value 
so  long  as  the  largest  component  is  still  in  the  positive  direction. 

An  example  of  the  command  is 

VMACH  0.  0.  -8. 


6.3-2 

This  would  cause  the  object  to  be  inverted  so  that  the  old  negative 
z-direction  becomes  the  positive  z-direction.  There  is  no  default 
value  for  this  command.  If  it  is  not  defined  ORIENT  terminates  with 
an  error  message.  (This  Implies  a  default  value  of  (0.,  0.,  1.),  no 
rotation.) 


For  a  description  of  the  following  ORIENT  keywords  see  Section 

6.21. 

BATCH 

COMMENT 

END 

INTERACT 

REMARK 

TABLE  6.31/1 

A  SUMMARY  OF  THE  ORIENT  KEYWORDS 

BATCH  Places  ORIENT  input  routines  in  a  batch 

input  mode.  The  default  mode  is 
interactive.  (See  INTERACT.) 

COMMENT  text  Causes  text  to  be  ignored  by  the  input 

routines.  Text  may  be  any  set  of 
characters  and  numbers. 

END  Marks  the  end  of  the  ORIENT  input. 

Should  be  included  at  the  end  of  all 
runstreams. 

INTERACT  Places  ORIENT  input  routines  in  their 

interactive  input  modes.  This  is  the 
default  mode.  (See  also  BATCH.) 

REMARK  text  Causes  text  to  be  ignored  by  the  input 

routines.  Text  may  be  any  set  of 
characters  and  numbers. 

VMACH  x  y  z  Defines  the  desired  orientation  by  the 

sign  and  location  of  largest  absolute 
component,  x  y  z  is  the  three  vector 
describing  the  Mach  vector  normalized  to 
the  Ion  acoustic  speed.  This  keyword 
must  be  defined  for  ORIENT  to  execute. 


Diagnostic  output  from  ORIENT  is  obtainable  by  using  the  VEHICL 
diagnostic  flags  defined  by  Section  6.22. 

6.32  RUNNING  ORIENT 

After  the  VEHICL  output  files  (or  a  copy  of  them)  have  been 
assigned,  the  runstream  shown  in  Figure  6.32/1  could  be  used  to  rotate 
the  satellite  defined  by  Figure  6.1/18  and  pictured  in  Figure  6.1/19 
so  that  neither  of  the  two  spheres  point  in  the  ram  direction.  After 
execution,  the  reoriented  object  can  be  viewed  using  the  SHONTL  module 
to  see  where  in  the  grid  the  object  ended  up. 

@XQT  ORIENT 
BATCH 

REMARK  ROTATE  FIGURE  6.1/19  TO  BE 
REMARK  SIDEWAYS 
VMACH  -1.  0.  0. 

REMARK  THAT  WAS  EASY! 

END 

Figure  6.32/1  Sample  ORIENT  runstream. 

Because  the  exact  center  of  the  grid  is  not  necessarily  on  a 
node,  the  object  may  move  a  grid  space  in  one  (or  more)  directions. 
This  can  cause  ORIENT  to  find  an  error  during  the  SREL  list  creating. 
The  error  is  due  to  the  object  touching  the  object  grid  boundary  at 
some  point.  As  previously  mentioned  (6.24),  this  error  is  cured  by 
expanding  the  object  grid.  Unfortunately,  only  VEHICL  can  do  this. 

So  object  must  first  be  redefined  in  a  larger  grid  by  VEHICL,  then 
rotated  by  VEHICL.  It  is  a  good  practice  to  add  an  extra  node  on  all 
sides  of  the  grid  if  reasonable  when  an  object  is  to  be  rotated. 


An  even  better  solution  is  to  use  an  odd  number  of  nodes  along 
each  axis.  Then  the  center  of  the  grid  will  fall  on  a  node  and  the 
object  should  not  touch  the  grid  boundary  in  ORIENT  if  it  did  not  in 
VEHICL. 


6.4-1 


6.45.  SUMMARY  OF  NTERAK  KEYWORDS 

NTERAK  is  the  program  that  calculates  the  plasma  interaction  and 
vehicle  charging.  Its  keyword  control  language  has  both  'verbs'  and 
'noun '-options.  A  run-language  sentence  is  constructed  in  the 
reverse-Polish  sense,  i.e.,  nouns  first,  verbs  last.  The  NTERAK  verbs 
are: 

PWASON  -  invokes  the  Poisson  solution 

CURREN  -  invokes  the  sheath  particle  tracking 

CHARGE  -  invokes  the  circuit  model  update  of  surface  potentials 

ENDRUN  -  run  finished 

The  following  is  a  list  of  the  NTERAK  keyword  options.  The 
first  column  is  the  keyword,  the  second  column  lists  the  possible 
responses.  Literal  options  are  listed  with  the  default  underlined. 
Numerical  responses  are  indicated  by  the  default  value  in  parentheses 
followed  by  the  variable  type  I,  for  integer;  F,  for  floating  point 
real  number,  E,  for  exponent  type,  i.e.,  1.2E12,  and  L,  for  literal 
(no  quotes). 


OPTION 


VALUE,  FORMAT 


EXPLANATION 


BATCH 

tutekact 

DEFAULTS 
I START 


I6ICAL 


SAVSET 


GISAVE 


NEW 


CONT 


X,L  #,  I 
Y »L  #,  I 
Z,L  #,  I 


Keyword  only  to  select 

operation  mode,  turn  prompts  on  or  off, 

etc.  non-critical . 

Set  or  reset  default  option. 

New  run.  Allows  for  the  calculation  of 
new  GI's  or  the  use  of  old  ones  if  the 
computation  grids  are  identical.  Space 
potentials  will  be  zeroed,  and  a 
precharge  step  (automatic  call  to  CHARGE) 
performed  according  to  CHARGE  options  if 
requested. 

Continue  a  run,  use  old  densities. 

Ignored  when  ISTART  ^  NEW. 

YES  -  calculate  new  GI's 

(expensive).  Default  for 
ISTART  -  NEW. 

NO  -  Use  1.0's  everywhere. 

OLDI  -  Use  old  DION's  from  previous 
run.  Mach  vector  and 
computational  grid  should  be 
identical.  Default  for  ISTART 
«  CONT. 

OLGI  Use  old  GI's  from  previous  run. 

YES  Equivalent  of  IGICAL  -  NO 

overrides  IGICAL  ■  YES  with 
exception  noted  by  GISAVE. 

NO  Leave  IGICAL  -  YES  alone, 

SAVSET  can  be  switched  at 
location  indicated  by  GISAVE. 

Two  fields  following  the 
keyword.  X  4  means  that  at  all 
nodes  in  the  plane  at  X  *  4, 
the  value  of  SAVSET  will  be 
temporarily  toggled.  Up  to 
nine  planes  may  be  entered. 


The  combination  IGICAL  YES,  SAVSET  NO,  and  GISAVE  Z  -3, 
GISAVE  Z  -4,  would  cause  the  neutral  ion  density 
calculation  (GI's)  to  be  calculated  everywhere  except  at 
Z  =  -3,  and  Z  *  -4.  IGICAL  YES,  SAVSET  YES,  GISAVE  X  4, 
GISAVE  Y  5,  GISAVE  Z  12,  would  cause  GI  values  to  be 
calculated  at  the  point  4  5  12  only. 


OPTION 


VALUE,  FORMAT 


EXPLANATION 


6.4-3 


EFLDCOR 

YES 

W 

Use  electric  field  corrections  to  the  ion 
density  calculations. 

I 61 OUT 

NO 

YTS 

Output  of  appropriate  densities. 

PRECHG 

PRE 

Starting  surface  potentials  from  a 
precharge  step. 

CONS 

Constant  surface  potentials.  Default  for 

I START-NEW. 

POTVAL 

5lK 

Initial  insulator  potential.  Default  is 
potential  of  conductor  1  (or  Vci). 

CONOV 

N  pot 

Initial  conductor  voltages  where  N  is  the 
conductor  number  (N-l  is  ground 
conductor)  and  pot  is  the  initial 
potential  in  volts. 

INSULPOT 

DIFF 

CONS 

Defines  POTVAL  to  be  the  initial 
DIFFerential  voltage  from  insulator 
surfaces  to  underlying  conductor  or  a 
CONStant  insulator  surface  voltage. 

FLOAT 

n 

Floats  conductor  n.  If  n  (a  conductor 
number)  is  omitted,  all  conductors  are 
floated  (the  default  condition). 

FIXP 

n  V 

Fixes  potential  of  conductor  n  to  V  volts. 

BIAS 

n  V 

Bias  potential  of  conductor  n  with 
respect  to  conductor  1  by  V  volts. 

RIJ 

i  j  r 

Sets  resistance  between  conductor  i  and 
conductor  j  to  r  ohms.  For  r  <  1ft, 
infinity  (also  default)  will  be  used. 

CIJ 

i  J  c 

Sets  capacitance  between  conductor  i  and 
conductor  j  to  c  farads. 

HELP 

Output  summary  of  option. 

OXMESH 

F,E 

Grid  spacing  length  in  meters. 

NXAONT 

(0),  I 

Number  of  nodes  added  to  the  object  grid 
in  the  +X  direction  to  set  up  the 
computational  space. 
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OPTION 

VALUE, 

FORMAT  EXPLANATION 

NXAONB 

(0),  I 

Add  nodes  in  -X  direction. 

NYADNT 

(0),  I 

Add  nodes  in  +Y  direction. 

NYADNB 

(0),  I 

Add  nodes  in  -Y  direction. 

NZADON 

(0),  I 

Add  nodes  in  -Z  direction. 

NZTAIL 

(0),  I 

Add  nodes  in  +Z  direction  (wake). 

IOGRID 

NO  L 

Output  grid  information. 

REMARK 

COMMENT 

Comment  out.  Runstream  options. 

NPHI 

(36), I 

Number  of  zenith  angle  divisions  for  GI 
calculation. 

NTH  ETA 

(180), I  Number  of  azimuthal  angle  division  for  GI 
calculation. 

NAOD 

(2), I 

Add  extra  vertices  to  object  shadow  in 
velocity  space  for  GI  calculations. 

VMACH 

VX  VY  VZ,F 

Mach  vector  units  of  /kT/m.  Default  is 
set  by  VEHICL  or  ORIENT. 

DENS 

(1.0E11),E,F 

Ambient  density  in  / m3. 

TEMP 

(0.2) ,E,F 

Ambient  temperature  in  eV. 

DEN2 

(0.0) ,E,F 

For  energetic  Maxwellian  in  m~3. 

TEMP2 

(0.0) ,E,F 

For  energetic  Maxwellian  in  eV. 

POWCO 

(0) ,E,  F 

Power  law  coefficient  /m^.sec.str.eV. 

PALPHA 

(0) ,E,  F 

Power  law  exponent. 

PCUTL 

(1.0E2),E,F 

Power  law  lower  cutoff,  in  eV. 

PCUTH 

(1.0E9),E,F 

Power  law  upper  cutoff,  in  eV. 

GAUCO 

(0) ,E,F 

Gaussian  distribution  coefficient 
/  nr.sec.str.eV. 

ENAUT 

(0) ,E,F 

Gaussian  peak  in  eV. 

DELTA 

(0) ,E,  F 

e-folding  width  of  Gaussian. 

RATIH 

(1.0E4) ,E,  F 

Ion  to  hydrogen  ratio. 
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OPTION 

VALUE, 

FORMAT  EXPLANATION 

AMU I ON 

(16.0) ,E,F 

Ion  mass,  in  AMU 

BMAG 

(.4),E,F 

Magnitude  of  B  field,  gauss. 

BDIR 

(-1  0  0) 

Vector  direction  of  B  field,  normalized 
by  code. 

BFIELD 

OFF  L 

wr 

Turn  magnetic  field  effects  on  and  off. 

FOR  PWASON 

MAXITS 

(2), I 

Space  charge  iteration  limit. 

MAXITC 

(10), I 

Potential  iteration  limit. 

MINITC 

(2), I 

Potential  iteration  lower  limit. 

RDRMIN 

E,  F 

Potential  convergence  test.  The  default 
value  is  number  of  nodes  *  .0001. 

POTCON 

(6) 

«  log  10  (RD0TR(l)/RD0TR(v) ) ,  potential 
convergence  test. 

IOCONG 

PART  L 

wr 

Output  control  of  potential  calculation. 

FULL 

I SPOUT 

PART  L 

Output  control  of  space  charge 
calculation. 

LAST 

To  get  final  potentials  from  PWASON. 

NO 

FULL 

PDIE 

(20*TEMP)E,F 

Maximum  allowable  positive  voltage  in 
screening  calculation. 

SQALPH 

(3)  ,F 

Space  charge  distribution. 
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OPTION 

VALUE.  FORMAT  EXPLANATION 

FOR  CURREN 

STHPOT 

PSIM  E.  F 

Particle  sheath  boundary  potential. 

PSIM  .  in(SQALPH*(x0/0XMESH)2) 

NTABLE 

(10), F 

The  number  of  entries  in  the  table  used 
by  SHEATH  to  calculate  presheath  weights, 

I  PC  NT 

(3), I 

The  maximum  number  of  left  and  right 
particle  pushing  sequences  allowed. 

CURPOT 

(-.45*TEMP) , 

E,F 

The  potential  at  which  the  presheath 
weights  are  calculated. 

FOR  CHARGE 

MAXITT 

(2)  I 

Number  of  timesteps. 

OELTAT 

(No  default)E,F 

Timestep,  seconds,  no  default. 

DVLIM 

(lOOO.)E,  F 

Voltage  change  per  step,  in  volts. 

IMPEXP 

IMPL 

exFl 

Normal  explicit-implicit  sequence. 
Explicit  only. 

VLTFIX 

(vf),e,f 

Estimated  potential  crossover  for 
non-charging  surfaces.  (Used  as  a 
boundary  on  calculation.)  Vp  * 
(AMUI0N*1.67xl0Z7/9.1xl031). 

VFIXHI 

(-10000), E,F 

Estimate  of  upper  (charging  cases) 
crossover  potential.  Used  as  a  boundary 
to  try  and  limit  voltage  swings.  Volts. 

DVTEST 

(5),E,F 

Guess  used  in  first  CHARGE  cycle  for 
voltage  change  in  previous  timestep. 
Volts. 

VWIGGL 

(.001),E,F 

Minimum  change  forced  when  a  surface  is 
near  its  equilibrium. 

XDVFAC 


(2),E,F 


Multiplies  DVLIM  to  be  used  in  first 
trial  of  a  CHARGE  cycle  to  guess  the 
potential  of  the  crossover  point. 


OPTION 


VALUE,  FORMAT 


EXPLANATION 
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FOR  DIAGNOSTICS 


IDIAGS(I) 

#,I 

Diagnostic  and  output  controls,  see 

JDIAGS(I) 

#,I 

Section  6.45.10. 

KDIAGS(#) 

#,I 

IBIAGS (#) 

#,I 

OUTPUT 

sec  quant 

Sets  a  set  of  DIAG  flags  appropriate  to 

subsection  (sec)  and  quantity  (quant). 
Valid  subsections  are  TIMER  (run  time 
Information),  PWASON,  CHARGE,  CURREN,  and 
NEUDEN  (the  neutral  ion  density 
calculation).  Valid  quantities  are  HIGH, 
LOW,  and  OFF.  Defaults  are  set  to  LOW 
for  all  subsections. 


SELECT  options  Used  to  select  specific  Z-slices  from 

large  tables  for  output.  Also  can  be 
used  to  turn  output  of  a  data  set  off  (or 
on).  The  various  options  are  described 
below. 


SELECT  name  list  ENDLIST 


SELECT  name  ALL 

TTOne 


Name  is  a  buffered  name  (5.30)  which  is 
sliced,  list  is  a  set  of  integers 
separated  by  blanks  which  are  object  grid 
Z-slice  values  (e.g.,  to  get  IZ»2  and  3 
of  POT  say  SELECT  POT  2  3  ENDLIST) 

Turns  on  or  off  output  of  name  (a  buffered 
set  of  data).  Default  is  on  (ALL). 


SELECT  LIST  n  list  ENDLIST  Defines  LIST  n  (1  <  n  <  5)  as  list  (see 

above). 


SELECT  name  LIST  n  Prints  LIST  n  Z-slices  when  name  data  is 

printed. 


6.45.10  NTERAK  DIAGNOSTICS  AND  OUTPUT  CONTROL 

The  diagnostic  keywords  recognized  by  NTERAK  are  IDIAGS(N)  and 
JDIAGS(N).  For  example,  a  runstream  might  contain  the  card 
IDIAGS(9)  1 

All  diagnostics  have  a  default  level  of  zero.  Diagnostic  flag  levels 
are  usually  recognized  in  a  >  sense;  i.e.,  larger  flag  levels  include 
all  the  lower  levels. 

The  diagnostic  flags  are  as  follows: 

IDIAGS(l)  used  by  PWASON 

*  2  CONGRD  output 
«  3  COPROD  output 

»  4  Additional  COPROD  info,  all  of  the  PCUBE  routines,  and 
DCVCEL  output 

*  5  Additional  DCVCEL  output 
IDIAGS(2)  CBUF  usage 

»  2  Information  from  DEBUF,  BUFSWP,  GETLAD,  BUFSET  (MORCOR 
calls,  IAVECS  settings) 

«  3  PAGER  (TIMER  calls  on  entry  and  exit) 

»  4  All  info  from  PAGER  and  GRIDIO 

IDIAGS(3)  VERTIO  check 

-  4  All  VERTIO  action 

IDIAGS(4)  TIMING 
.  1  in  OPTIN 

«  2  in  CHARGE,  IONOEN,  CONGRD 


3  in  PAGER 
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I DI AGS( 5)  Self  diagnostics 

-2  GRIDIO  (calls  CHKPUF  to  check  the  addressing  system). 
IONDEN  plus  others  possibly  in  future  (calls  CHKLOC  to 
issue  warnings  if  addresses  within  CBUF  are  too  big  to  be 
passed  within  a  word.) 

■3  CHKLOC  prints  core  locates  of  the  all  locations  passed  to 
it. 

»4  CHKLOC  generates  non-fatal  walkbacks  for  warning 
situations. 

■5  CHKLOC  generates  non-fatal  walkbacks  for  all  calls  to  it. 


IDIAGS(6)  Trajectory  tracing  (CURREN) 

■  1  Trajectory  progress  checking 

«  2  PRNTSL  (particle  reading  and  writing)  action,  particle 
movement  at  the  slice  level 

«  3  Complete  output  from  PRNTSL,  print  out  the  various  grids 
used  by  CURREN  on  exit 
«  4  Print  individual  particle  movements 

*  5  Energy  checking  diagnostics 


I DI AGS( 7 )  QSELT 

■  4  QSELT  information 


IDIAGS(8)  CHARGE 

■  0  Echo  input 

■  1  Control  flow  info 

■  2  Voltage  results  from  ICCG 

«  3  Input  to  ICCG,  previous  cycle  data,  material  info 
«  4  Intermediate  subroutine  output 

«  5  Surface  by  surface  calculations 

*  6  FLUXEL  and  FLUX8K  output,  CHKIMV  surface  checking 
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I DI AGS ( 9 )  IONCUR 

«  1  Print  SR FI  list 

»  2  Intermediate  lists 

*  3  Weight  calculation  results 

>  4  Weight  calculations 

»  5  Particle  lists  from  CURRENT 


JDIAGS(l)  SREL  (VEHICL) 

»  0,1  No  output 

»  2  Print  out  LCEL  and  SREL  lists.  Also  information  from 
RECELL,  SREL  index  to  LCEL. 

■  3  Print  out  preliminary  LCEL  list 

*  4  Detailed  output  from  routines  constructing  LCEL  and  SREL 
lists. 


JDIAGS(2)  SHEATH  calculation 

*  3  Print  presheath  Information 

JDIAGS(3)  PRECHG 

«  2  Print  ambient  Ion  currents  calculated  by  AMBCUR 
-  3  ASRF  from  ALSURF 

JDIAGS(4)  IONDEN 

>  1  Print  progress  notes 

=  3  SHFTIT  results  {for  filled  or  partially  filled  elements) 

JDIAGS(5)  Double  point  data 

a  2  Potentials  from  POTSET 
a  3  On  input  to  major  modules  and 

double  point  locations  from  SPDPNT  (vehicl) 
a  4  More  double  point  information  from  SPDPNT  (vehicl) 

JDIAGS(6)  RHOI  values 

a  2  Print  RHOIs  after  completion  of  CURREN  (in  CUEXIT) 


V  *•* : 
%•  v*  *  >. 
v**;?  •.:< 

1  w*  a  1 

■v  ^ 


t 


JDIAGS(7)  Particle  pushing  error  control 

-  1  Print  info  for  particle  in  error 

-  3 

»  4  Kill  run  if  5  percent  of  particles  are  lost  to  errors 

■  5  Oie  instantly  when  an  error  occurs 

JDIAGS(8)  Modified  CHARGE  output 

«  1  Final  surface  voltage  for  the  cycle,  including  INISET 
«  2  Initial  FTOT  and  FSM  used  (total  current  and  total 
secondary  current) 

«  3*  Components  of  current  for  each  surface 
*  Note  that  the  information  produced  by  JDIAGS(8)  *2  is  included 
in  JDIAGS(8)  *  3  so  the  flags  are  exclusive. 

JDIAGS(9)  MTLGEN  (in  VEHICL) 

-  2  Print  calculated  AMAT 

-  4  Print  all  appropriate  information 

JDIAGS(9)  IONGEN  (in  NTERAK) 

.  2  IONGEN  prints  DIONs 

=  3  IONGEN  prints  ITYPs 

KDIAGS(l)  MSMODS 

«  1  Routines  echo  calls  to  themselves 
*  2  Perform  tracebacks  when  called  to  find  caller 

KDIAGS(2)  CHKSTH,  CHKTRO 
«  3  Echo  commands 

KDIAGS(3)  E  field  correction  to  geometric  ion  densities 
«  2  Print  tables  which  will  be  used 

KDIAGS(4)  DBLCHK  (particle  validation) 

■  2  Potentials  for  rejected  particles 

■  4  Position  velocity  for  all  particles 


I 

i 


■ 


k  * 
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6.50  OPERATING  SHONTL 

SHONTL  is  POLAR's  general  plotting  and  information  extraction 
program.  Its  primary  sources  for  these  functions  are  the  two  mass 
storage  files,  11  and  19.  For  certain  functions,  SHONTL  will  actually 
duplicate  NTERAK  calculations. 

SHONTL' s  primary  plotting  mode  is  to  construct  two-dimensional 
contour  plots  of  data  slices  perpendicular  to  any  of  the  three 
coordinate  axes.  Currently,  the  following  variables  may  be  viewed  in 
this  fashion:  neutral  ion  densities  ('Si's),  composite  ion  densities 
(’DION's),  stabilized  charge  densities  ('QUSD'),  and  potentials 
('POT').  In  addition,  SHONTL  can  execute  the  CURREN  module  of  NTERAK 
and  superimpose  the  results  on  any  of  the  contour  plots.  In 
particular,  there  are  two  types  of  graphical  output  from 
SHONTL-CURREN.  The  sheath  location  can  be  indicated  by  a  contour  of 
X's  using  either  the  sheath  potential  that  was  used  by  NTERAK-CURREN, 
or  optionally  changed  with  the  STHPOT  keyword  (Section  6.52);  also, 
ion  trajectories  may  be  displayed  with  the  following  options:  A  total 
perspective  of  complete  trajectories  projected  onto  the  plot's  slice 
(keyword  PERSPC),  the  portion  of  all  trajectories  that  pass  through 
the  plot  slice,  trajectories  emanating  from  a  ring  of  sheath  points 
lying  in  selected  X-Y  plane  (X-Y  only)  (keyword  RING)  which  can  also 
use  the  PERSPC  option,  and  in  addition  to  all  of  the  above  the  WEED 
option  will  throw  out  about  75  percent  of  the  trajectories  to  reduce 
plot  cluttering  and  computing  costs.  Finally,  a  single  point 
trajectory  option  is  also  available  (keyword  SPOTS). 

Other  plotting  features  are  limited  to  a  spectrum  plot  of  the 
energetic  electron  environment.  Future  modifications  will  allow 
SHONTL  to  reproduce  the  material  plots  and  the  hidden  line  object 
perspective  views  that  are  currently  available  only  from  VEHICL. 
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In  addition  to  plotting,  SHONTL  can  output  to  a  printer  (or 
whatever)  the  current  values  of  virtually  any  variable  stored  on  files 
11  and  9,  through  the  use  of  the  PRINT  NAME  keyword  where  NAME  would 
be  the  exact  FORTRAN  name  of  any  variable  known  to  MRBUF  (a 
subroutine).  A  list  of  these  can  be  found  in  Section  5.33.  The 
format  for  this  output  is  generally  identical  to  that  used  by  VEHICL, 
ORIENT,  and  NTERAK  when  these  variables  are  output  from  these 
modules.  A  note  of  warning  -  variable  aliasing  is  not  always 
identical  between  modules.  For  example,  potentials  would  be  output  by 
NTERAK  by  the  'card* 

I SPOUT  FINAL 

which  would  produce  potential  array  output  (modified  by  the  SELECT 
keyword)  at  the  conclusion  of  a  spacecharge-potential  calculation  (the 
PWASON  submodule  of  NTERAK).  Whereas  in  SHONTL  one  would  enter  the 
cards 

SELECT  -  options  - 
PRINT  POT 

to  get  the  same  output. 

Like  the  other  modules,  SHONTL  keywords  fall  roughly  into  two 
categories  that  can  be  described  as  verbs  and  adverbs.  For  example,  a 
user  might  enter  the  following  adverb  cards  to  set  up  plot  parameters: 
PLOTS  ON 
LEVELS  20 
LEVELS  NOMARK 
6RDPTS  ON 
SHEATH  ON 

followed  by  the  verb  card 
POT  X 

which  would  trigger  the  actual  production  of  a  potential  contour  plot 
with  a  sheath  indicated,  no  contour  markings,  approximately  20  contour 
levels,  and  all  grid  points  indicated. 
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Finally,  plots  (but  not  output)  are  generated  in  a  machine 

independent  fashion  on  file  2.,  and  a  post-processor  (usually 

PLOTREAD)  is  used  to  interface  to  the  local  graphics  package. 

Depending  upon  installation  and  requirements,  the  user  might  want  file 

2  to  be  a  permanent  file. 

6.51  STEP  BY  STEP  INSTRUCTIONS  FOR  SHONTL 

Step  1:  Two  data  files  are  needed  by  SHONTL.  They  are  file  11, 

and  these  files  must  be  named  11  and  19.  The  best  way  to 
do  this  on  the  UNIVAC  is  to  use  the  @USE  command. 

Step  2:  Enter @XQT  P0LAR*SH0ABS. SHONTL. 

Step  3:  Now  you  need  to  enter  the  information  needed  to  retrieve 

the  slice  you  wish  to  plot.  The  instructions  for  the 
input  routine  are  in  the  form  of  keywords  (6.52). 
Additionally,  there  are  several  commands  to  help  use  the 
keywords  to  get  the  desired  plots  (6.52). 

The  first  step  is  to  choose  the  plotting  features  you  wish 
to  use.  These  include  marking  the  grid  boundaries, 
showing  the  silhouette  of  the  object,  marking  the  grid 
points,  choosing  the  axis  for  the  problem  and  choosing  a 
title  for  the  plot.  (There  is  a  complete  list  of  the 
keywords  in  the  next  section.) 

Step  4:  When  all  of  the  desired  features  have  been  chosen,  a  slice 

needs  to  be  defined.  At  this  point  a  plot  is  generated. 
There  are  several^gseful  defaults  which  produce  sets  of 
plots  (see  6.  53fJ  Now  one  can  return  to  step  4  to  produce 
additional  graphs  or  continue  onto  step  5. 

Step  5:  To  leave  SHONTL,  type  ExiT  if  you  want  hard  copies  of  the 

plots  to  be  generated.  Type  ESC  (for  escape)  if  no  hard 
copies  are  desired.  The  EXIT  command  will  call  PLOTRD 
automatically. 

Show  all  of  your  friends  your  nifty  plots. 


Step  6: 
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6.52  SHONTL  KEYWORDS 

The  following  is  the  current  list  of  SHONTL  keywords.  All  of 
the  input  which  cannot  be  recognized  is  simply  printed  on  the  screen 
and  then  ignored. 

The  form  of  a  keyword  definition  is 

KEYW0RD[,  equivalent  forms ](*defau It  setting*/other  settings) 

definition 

The  terms  "ON"  and  "OFF"  describe  the  setting  of  the  option.  So  if 
something  is  set  to  "OFF",  it  will  not  appear  on  the  plot.  For 
example, 

PLOTS  OFF 

will  cause  those  plots  generated  while  the  flag  is  off,  to  not  be 
printed.  Since  default  value  of  PLOTS  is  off,  to  prevent  undesired 
plots,  the  definition  of  PLOTS  looks  like 

PLOTS  (*0FF*,0N)  causes  the  . 

Here  is  the  present  keyword  list: 

ALL  (ON/OFF)  turns  all  of  the  on/off  switches  to  ON  or  OFF. 

"ALL  ON"  would  turn  on  all  of  the  keywords  which  can  be  set  to 
(ON/OFF). 

AXORAW  (*0N*/0FF)  controls  the  printing  of  the  plot  axis,  scale 
values,  and  axis  labels. 

A2SURF  (*0N*/0FF)  controls  the  printing  of  the  object's 
silhouette. 

COLOR  (0N/*0FF*)  turns  on  color  filled  features.  This  may 
depend  on  the  use  of  a  Jupiter. 

COMMENT  causes  the  input  routine  to  ignore  the  rest  of  the 
line.  Note  that  only  the  first  six  characters  on  the  line  are 
actually  read. 


CONLIN  (*ON*/OFF)  controls  the  printing  of  the  contour  lines  on 
the  plot. 

OEBYE  causes  the  scale  on  the  plot  to  be  in  Debye  lengths.  The 
origin  (0,0)  is  the  object  grid  origin  (see  'GRID').  The  normal 
default  is  to  grid  units. 

DEN$IT,DEN,D.  This  is  a  request  for  a  plot  of  a  slice  of 
density  data.  The  allowable  forms  of  requests  for  density 
slices  are 

DENSIT  X  N 
DENSIT  X  MIDDLE 
DENSIT  X 
DENSIT 

where  either  of  the  abbreviations  may  be  substituted  for 
DENSIT.  Also  Y  or  Z  can  be  used  for  X,  MID  can  be  used  for 

middle,  and  N  is  a  positive  integer  on  the  axis  (X,  Y,  or  Z) 

that  is  in  the  grid  space.  The  axis  is  the  axis  perpendicular 
to  the  plane  of  the  slice.  If  form  2  or  3  are  used,  the  middle 
of  the  object  grid  will  be  plotted.  If  the  last  form  is  used, 
the  middle  X  and  Y  slices  will  be  plotted. 

ERASE  causes  any  plots  which  have  been  created  to  be  erased  and 
not  produced  by  PLOTRD. 

ESC  causes  the  SHONTL  module  to  be  exited  immediately  without 
any  additional  output.  (The  keyword  ESCAPE  is  equivalent.) 

EXIT  signals  the  end  of  the  input.  If  no  plots  have  been 

requested  at  this  point  and  'PLOTS'  is  'ON',  then  four  plots 

will  automatically  be  produced.  They  will  be  plots  of  the 
potential  and  density  at  the  middle  of  the  X  and  Y  axes. 

FILLIN  (*0FF*/0N)  causes  the  interior  of  the  object  to  be 
filled.  The  routine  looks  for  zeros  surrounded  by  relatively 
big  numbers.  This  changes  the  appearance  of  the  contour  lines 
in  a  way  which  may  be  desirable.  (Obsolete.) 

FRAME  (*PLASma*/CRAFt)  -  (**/X  Y  Z).  This  keyword  chooses  the 
reference  frame  for  viewing  potentials.  The  default  is  the 
plasma  frame  used  by  NTERAK,  but  a  spacecraft  frame  may  be 
chosen  where  the  ?xB  electric  field  will  appear  at  'infin  ity\ 

In  the  spacecraft  frame  the  definition  of  plasma  ground  will 
appear  arbitrary  (it  is  not  really)  but  it  may  be  shifted  from 
the  point  chosen  by  NTERAK. 

GETSLC  (*0N*/0FF)  causes  the  plot  generation  routine  to  read  a 
slice  from  the  data  file. 

GRDPTS  (0N/*0FF*)  causes  crosses  to  be  printed  at  each  of  the 
nodes. 
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GRID  causes  the  scale  of  the  plot  axes  to  be  in  object  grid 
units.  The  reference  point  in  this  coordinate  system  is  the 
lower  left  corner  of  the  object  definition  grid  which  is  defined 
to  be  (1,1).  This  is  the  default  scaling. 

HEADNG  (*0N*/0FF)  causes  the  heading  to  be  printed  at  the  top  of 
the  plot. 

IDIAGS(N)  is  the  keyword  input  section  which  allows  setting  of 
any  of  the  IDIAGS  flags.  For  information  concerning  the  IDIAGS, 
see  Section  6.70. 

INPSPT  (*0*).  The  keyword,  INPSPT  (INPUT  SPOT),  is  used  to 
trace  the  trajectory  of  a  number  of  particles  (SPOTS)  which  the 
format  for  keyword  is  "INPSPT  N",  where  N  is  the  number  of 
points  to  be  entered.  The  maximum  number  of  points  is  20. 

After  the  INPSPT  keyword,  the  N  particles  are  defined  by  giving 
their  initial  position  (X,Y,Z)  and  velocity  (VX,VY,VZ).  For 
example,  if  we  wanted  to  define  two  particles,  one  with  the 
position  (4. ,5. ,6.)  in  grid  units  and  velocity  (-.l,-.l,-4.) 
normalized  to  the  ion  acoustic  speed  (see  documentation,  POLAR 
Manual,  Section  5.62.12),  and  a  second  particle  with  the 
position  (— 1. ,3. ,—2.5)  and  a  velocity  of  (-l.,-.3, .01)  we  would 
enter: 

INPSPT  2 

4.  5.  6.  —.1  —.2  —4. 

-.1  -.3  -2.5  -1.  -.3  .01 

JOIAGS(N) .  See  entry  for  IOIAGS(N). 

KDIAGS(N).  See  entry  for  IDIAGS(N). 

LEVELS  (*10*-AUT0)  set  the  number  of  contour  lines  to  be  drawn 
and  their  selection  mode.  The  keyword  LEVELS  is  also  an  entry 
word  to  the  following  contour  options: 

LEVELS  AUTO  linearly  spaced  contours,  rounded  to  nice 

numbers,  for  potentials,  the  kT  and  0.i*kT 
contour  will  be  added  and  the  kT  level 
marked. 

LEVELS  NOMARK  turns  off  all  contour  marking. 

LEVELS  MARK  VALUE  MARKER  will  mark  the  contour  level  at  VALUE 

with  the  first  character  of  MARKER. 
Marking  with  a  number  can  be 
accomplished  by  #LIL  where  #  is  a 
number  and  L  is  any  letter.  Only  # 
will  be  used,  but  the  LLL  is 
necessary  for  #  to  be  recognized  as 
a  literal.  This  command  may  be 
repeated  to  mark  up  to  nine  levels. 
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LEVELS  ADD  VALUE,  add  a  contour  level 

LEVELS  SUB  VALUE,  remove  a  contour  level 

LEVELS  SELECT  VALUE,  turn  off  auto  mode  and  use  Input  levels 

LINEAR  means  the  contour  lines  will  be  of  the  unmanipulated  data 
in  the  slice.  This  is  the  default  mode. 

LOG  causes  the  contours  to  be  of  the  natural  log  of  the  slice 
data.  The  normal  default  is  'LINEAR'. 

L0G10  causes  the  contours  to  be  of  the  base  10  log  of  the  slice 
data.  The  normal  default  is  'LINEAR1. 

METERS  causes  the  units  of  the  scale  of  the  plot  axis  to  be  in 
meters.  The  origin  (0,0)  is  the  object  grid  origin  (see 
'GRID').  The  units  default  to  grid  units. 

MIDDLE.MID.  These  keywords  must  follow  X,  Y,  or  Z  to  be 
meaningful.  In  this  context,  they  cause  the  plot  to  be  of  the 
middle  of  the  object  grid.  (For  a  more  exact  description  of  the 
middle  of  the  grid,  see  'DENSITY'.) 

NONE.  This  keyword  can  be  substituted  for  POTENT  or  OENSIT.  It 
will  cause  plots  to  be  made  without  potentials  or  ion 
densities.  It  can  be  used  to  look  at  the  output  from  VEHICL. 
When  plots  of  sheaths  and  trajectories  are  made,  it  is  also 
helpful.  The  syntax  for  NONE  is  exactly  the  same  as  for  POTENT 
or  DENSIT. 

NUMBER  (0N/*0FF*).  NUMBER  is  used  when  tracing  particles.  If 
it  is  used  in  conjunction  with  IDIAG(6)*5,  the  particle  pusher 
will  number  the  particles  for  diagnostic  output.  This  is  very 
useful  for  debugging  the  CURREN  segment.  (See  also  the  notes  on 
IDIAGS. ) 

OBJCNR  (0N/*0FF*)  causes  four  small  boxes  to  be  drawn  in  the 
corners  of  the  object  grid. 

OBJGRO  (0N/*0FF*)  causes  the  object  grid  to  be  plotted. 

OUTREL  (*0N*/0FF)  causes  the  outer  stepped  grid  of  real  nodes  to 
be  plotted. 

OUTVIR  (*0N*/0FF)  causes  the  outer  stepped  grid  of  virtual  nodes 
to  be  plotted. 

PERSPC  (0N/*0FF*).  When  PERSPC  is  on,  all  of  the  sheath  points 
and  trajectory  paths  will  be  plotted.  If  it  is  off,  then  only 
those  points  or  paths  which  are  in  or  cross  the  slice  being 
drawn  will  be  shown. 
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PLOTS  (ON/*OFF*)  causes  the  plots  to  be  produced.  If  it  Is  off, 
the  slices  will  be  read  and  processed  for  plotting,  but  will  not 
be  plotted. 

PLTGRD  causes  the  scale  of  the  axis  to  be  in  plotting  grid 
units.  These  are  the  same  size  as  object  grid  units  but  the 
lower  left  corner  is  defined  to  (0,0).  In  object  grid  units, 
the  reference  point  on  id  is  the  lower  left  corner  of  the 

object  definition  gric  -  ,  is  defined  to  be  (1,1).  The 

default  is  object  gria  ji.cs. 

POTENT, POT, P.  This  is  the  same  as  'DENSIT'  except  potential 
slices  Instead  of  density  slices  will  be  plotted.  Please  see 
'DENSIT*  for  more  Information. 

PRINT  name  causes  name  to  be  read  from  the  appropriate  file. 
Valid  name  replacements  are  any  of  the  buffered  data  lists 
mentioned  in  Section  5.33.  For  larger  data  sets,  the  use  of 
SELECT  Is  recommended  (see  below). 

PRTSLC  (*0FF*/0N)  causes  a  grid  of  Integers  to  be  printed.  This 
is  helpful  to  examine  a  slice  for  plotting  before  a  plot  is 
actually  produced.  Be  sure  to  turn  'PLOTS  OFF1  If  plots  are  not 
desired. 

RESET.  This  keyword  resets  all  of  the  plotting  flags  to  their 
initial  values. 

RING  (0N/*0FF*).  Sometimes  on  large  problems.  It  is  desirable 
to  trace  fewer  particles.  One  way  to  do  this  Is  just  follow  a 
ring  of  particles.  Presently  the  only  rings  In  the  XY  plane  can 
be  made.  N  is  the  Z  slice  of  the  ring.  If  a  ring  in  the  Z*22 
slice  was  desired,  the  keyword  would  be  "RING  22".  If  RING  is 
followed  by  ON  or  nothing  at  all,  the  middle  Z  slice  will  be 
used. 

SELECT  options  used  to  choose  particular  Z-slices  for  printing 
when  using  PRINT  or  a  OIAG  (or  IDIAGS,  etc.)  flag.  Many  options 
are  available  and  the  user  Is  referred  to  Section  6.44,  6.45  or 
6.70. 

SHEATH  (0N/*0FF*)  causes  the  sheath  points  to  be  printed  on  the 
plot. 


SPOTS  (0N/*0FF*).  To  push  a  few  test  particles  to  see  which 
trajectories  they  will  take,  use  the  SPOTS  flag.  To  enter  these 
particles,  see  INPSPT.  It  is  recommended  that  PERSPC  Is  ON  when 
SPOTS  Is  used. 

STHPOT  N.  The  SHEATH  potential  for  plotting  the  sheath  can  be 
changed  by  resetting  STHPOT.  The  initial  value  is  the  same  as 
the  value  used  by  CURREN  during  NTERAK.  N  is  a  real  number. 
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TITLE.  Used  to  define  the  title  to  be  put  on  the  plot.  The 
default  is  "POLAR  PLOTS".  The  desired  plot  title  should  start 
in  the  ninth  column  of  the  card 
1234567890123456 
TITLE  BIG  BIRO 

In  the  above  example,  the  heading  appearing  on  the  plot  would  be 
"BIG  BIRD”.  Currently  there  Is  a  16  character  maximum. 
(Presently  un implemented.) 

TRAJ  (ON/*OFF*).  This  flag  turns  on  plotting  of  particle 
trajectories. 

WEEO  (*ON*/OFF).  This  flag  reduces  the  number  of  particles 
usually  found  by  CURREN  by  about  a  factor  of  4.  This  not  only 
speeds  up  the  plotting  process  but  also  makes  the  plots  a  little 
clearer. 

WHAT  causes  all  of  the  print  options  and  their  current  settings 
to  be  printed  at  the  terminal. 

X,Y,Z  the  axis  perpendicular  to  the  slice  to  be  plotted.  If 
both  potential  and  density  plots  are  desirable,  something  like 
X  8 

can  be  typed.  This  plots  the  X  *  8  slice  of  the  density  and  the 
potential  data.  Instead  of  8,  any  Integer  containing  part  of 
grid,  middle  or  mid,  or  nothing  at  all  can  be  used.  Nothing  at 
all  will  default  to  a  middle  slice.  Valid  forms  are 
X  N 

Y  MIDDLE 
Z  MID 
X 

where  X,  Y,  and  Z  are  interchangeable  and  N  is  any  integer  as 
described  above.  Please  see  'DENS IT'  for  more  information. 
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6.53  SPECTRUM  KEYWORDS  AND  OPERATING  INSTRUCTIONS 

The  spectrum  plots  are  generated  by  SHONTL  using  the  plasma 
characteristics  used  by  a  previous  NTERAK  run  or  by  defining  the 
environment  using  the  same  keywords  used  in  NTERAK. 

SHONTL  keywords: 

(Note  that  the  range  of  values  plotted  on  the  vertical  axis  is 
currently  not  controllable  by  the  user  and  is  limited  to  six 
orders  of  magnitude  down  from  the  maximum  flux  while  in  the 
LGLINY  LOG  mode.) 

Default  options  are  marked  by  surrounding  *'s.  These  *'s  are 
not  part  of  the  keyword. 

6.54  SHONTL  DEFAULTS 

SHONTL  has  lots  of  defaults.  All  of  the  plot  features  have 
defaults  (6.52).  There  are  also  slice  default  values  for  which  slices 
are  printed.  The  current  slice  defaults  are  also  in  Section  6.52 
under  the  'DENSIT'  definition. 

The  default  values  will  vary  as  the  plotting  requirements 
change.  The  best  place  to  look  for  default  changes  will  probably  be 
the  code  itself.  The  WHAT  command  gives  the  feature  defaults. 
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HIGHER  n  n  is  the  value  of  the  energy  cutoff  on  the 

high  end. 

INKEV  NO  y  axis  always  in  eV,  x  axis  is  variable. 

*YES* 

LGLINY  log  a  log  10  or  linear  plot  of  data  on  the  vertical 

*1 in*  axis. 


LGLINX  log  a  log  10  or  linear  plot  of  data  on  the  horizontal 

*1 i n*  axis. 

NPTS  n  number  of  points  to  be  calculated  and  connected 

(0  <  n  <  200). 

RLOWEN  n  n  is  the  value  of  the  low  energy  cutoff  on  the 

horizontal  axis. 


SPECTRUM  draw  a  spectrum  plot  using  the  previously  entered 

information. 


WRITE 


write  the  plasma  environment  generated  so  far 
during  the  current  run  onto  files  11  and  19. 


